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INTRODUCTION 


This manual is intended to supplement the information contained 
in the Enhanced Onyx System V User Reference Manual and to pro- 
vide an easy reference volume for those who must administer a 
UNIX system. Accordingly, only those commands and descriptions 
deemed appropriate for system administrators have been included 
here. 

This manual is divided into three sections: 

1. System Maintenance Commands and Application Programs 

7. Special Files 

8. System Maintenance Procedures 

Throughout this volume, each reference of the form name(IM), 
name(7 ) , or name(8) refers to entries in this manual, while all 
other references to entries of the form name(N) , where N is a 
number possibly followed bv a letter, refer to entry name in Sec- 
tion N of the Enhanced Onyx System V Programmer Reference or User 
Reference Manuals. 

Section 1: System Maintenance Commands and Application Programs 

This section contains system maintenance programs such as fsck, 
mkfs, etc., which generally reside in the directory /etc; these 
entries carry a sub-class designation of ” 1M M for cross- 
referencing reasons. 

Section 7: Special Files 

This section discusses the characteristics of each system file 
that actually refers to an input/output device. The names in 
this section generally refer to device names for the hardware, 
rather than to the names of the special files themselves. 

Section 8: Special Maintenance Procedures 

This section describes crash recovery and boot procedures, facil- 
ity descriptions, etc. 

Each section consists of a number of independent entries of a 
page or so in length. The name of the entry appears in the upper 
corners of its page. Entries within each section are alphabet- 
ized, with the exception of an introductory entry that begins 



each section. Some entries may describe several routines, com- 
mands, etc. In such cases, the entry appears only once, alpha- 
betized under its "major" name. 

All entries are based on a common format, not all of whose parts 
always appear in the following manner. 

The NAME part gives the name(s) of the entry and states briefly 
i t s p ur po se . 

The SYNOPSIS summerizes the use of the program being described. 
A few conventions are used, particularly in Section 1 (Commands): 

Boldface strings are literals and are to be-typed just 
as the appear. 

Italic strings usually represent substitutable argument proto- 
types and program names found elsewhere in the manual. (They are 
underlined in the typed version of the entries.) 

Square brackets [] around an argument prototype indi- 
cate that the argument is optional. When an argument 
prototype is given as "name" or "file," it always 
refers to a file name. 

Ellipses ... are used to show that the previous argu- 
ment prototype may be repeated. 

A final convention is used by the commands themselves. 
An argument beginning with a minus -, plus + , or equal 
sign r is often taken to be some sort of flag argument, 
even if it appears in a position where a file name 
could appear. Therefore, it is unwise to have files 
whose names begin with -, +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) or usage, where appropriate. 

The FILES part gives the file names that are built into the pro- 
gram. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that 
may be produced. Messages that are intended to be self- 
explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiences. Occa- 
sionally, the suggested fix is. also described. 



A table of contents precedes Section 1. On most systems, all 
entries are available on-line via the m an ( 1 ) command (see Section 
1 of the Enhanced Onyx System V User Reference Manual). 
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handle special functions of DAST 300 and 300s terminals /300s: 300(1) 
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LP requests. accept, reject: allow/ prevent ..... accept(IM) 

utime: set file access and modification times utime(2) 

a file touch: update access and modification times of .. touch(l) 

of a file access: determine accessibility ... access(2) 

machine/ sputl, sgetl : access long integer data in a sputl(3X) 

sadp: disk access profiler sadp(1) 

ldfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(IM) 
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accounting and miscellaneous accounting commands, /of acct(IM) 

acct: per-process accounting file format acct(4) 

acctcom: search and print process accounting file(s) acctcom(l) 

acctmerg: merge or add total accounting files. acctmerg(IM) 

summary from per-process accounting records, /command ...... acctcms(IM) 

wtmpfix: manipulate connect accounting records, fwtmp, fwtmp(IM) 

turnacct: shell procedures for accounting, /startup, acctsh(lM) 

accounting acct: enable or disable process ... acct(2) 
format acct: per-process accounting file . acct(4) 

per-process accounting/ acctcms: command summary from acctcms(IM) 
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connect-time accounting. acctconl, acctcon2: acctcon(IM) 

accounting, acctconl, acctconP: connect-time acctcon(IM) 

acctwtmp: overview of/ acctdisk, acctdusg, accton, acct(IM) 

overview of/ acctdisk, acctdusg, accton, acctwtmp: acct(IM) 

accounting files. acctmerg: merge or add total acctmergOh 
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acctdisk, acctdusg, accton, acctwtmp: overview of/ .... acct(IM) 

accounting. acctprcl, acctprc?: process acctprcdM) 

acctprcl, acctprcP: process accounting acctprc(IM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/ acct(IM) 

functions sin, cos, tan, asin, acos, atan, atanP: trigonometric .. trig(3M) 

killall: kill all active processes killall(IH) 

sag: system activity graph sag(1) 

sal, saP, sadc: system activity report package sar(IM) 

sar : system activity reporter sar(1) 

report process data and system activity timex : time a command; ... timex(l) 

formatting/ mosd ; the OSDD adapter macro package for mosd(5) 

adduser: add a user to the system . .. add U ser(1M) 

acctmerg: merge or add total accounting files acctmerg(IM) 

adduser: add a user to the system . adduser(IM) 

alarm: set a process’s alarm clock alarm(P) 

clock alarm: set a process's alarm ...... alarm(P) 

sbrk: change data segment space allocation brk, brk(P) 

realloc, calloe: main memory allocator malloc, free, malloc(3C) 

accept, reject: allow/ prevent LP requests. accept(IM) 

fsba: file system block analyzer fsba(IM) 

sort: sort and/or merge files sort(1) 

link editor output a. out: common assembler and ....... a.out(4) 

aouthdr: optional aout header aouthdr (4) 

aouthdr: optional aout header ..... aouthdr(4) 

introduction to commands and application programs intro: intro(l) 

maintenance commands and application programs, /system ..... intro(IM) 

maintainer for portable/ ar : archive and library ar(1) 

ar : common archive file format .... ar(4) 
language be: . arbitrary-precision arithmetic .... bc(1) 

cpio: format of cpio archive cpio(4) 

for portable archives ar : archive and library maintainer .... ard) 

ar : common archive file format ar(4) 

archive header of a member of an archive file ldahread; read the ... ldahread(3X) 

archive file ldahread; read the archive header of a member of an .. ldahread(3X) 

tar: tape file archiver tar(1) 

library maintainer for portable archives ar: archive and ar(1) 

cpio: copy file archives in and out cpiod) 

command xargs: construct argument list(s) and execute xargsd ) 

getopt: get option letter from argument vector getopt(3C) 

echo: echo arguments echoCD 

expr; evaluate arguments as an expression expr(1) 

be: arbitrary-precision arithmetic language bc(1) 

number facts arithmetic: provide drill in ...... ar ithmetic(6) 

expr: evaluate arguments as an expression expr(1) 

as- common assembler as(1) 

asa: interpret ASA carriage control characters ... asad) 

control characters asa: interpret ASA carriage asad) 

ascii: map of ASCII character set ascii(5) 

set ascii: map of ASCIT character ascii(5) 

between long integer and base-64 ASCII string /164a: convert a641(3C) 

number atof: convert ASCII string to floating-point .... atof(3C) 

time/ ctime, localtime, gmtime, asetime, tzset: convert date and ,, ctime(3C) 
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trigonometric/ sin, cos, tan, asin, acos, atan, atan?: trig(3M) 

help: ask for help help(l) 

as- common assembler as( 1 ) 

a .out : common assembler and link editor output .. a.out(4) 

assert: verify program assertion .. assert(3X) 

assert: verify program assertion assert(3X) 

setbuf: assign buffering to a stream setbuf(3S) 

/list the spared sectors associated with a slice ... sparelist(8) 

sin, cos, tan, asin, acos, atan, atan2: trigonometric/ trig(3M) 

sin, cos, tan, asin, acos, atan, atan?: trigonometric functions .... trig(3M) 

floating-point number atof: convert ASCII string to atof(3C) 

strtol, atol , atoi: convert string to integer ... strtol(3C) 

integer strtol, atol, atoi: convert string to strtol(3C) 

wait: await completion of process wait(i) 

processing language awk: pattern scanning and awk(1) 

ungetc: push character back into input stream ungetc(3S) 

back: the game of backgammon back(6) 

back: the game of backgammon back(6) 

fine: fast incremental backup finc(IM) 

daily/weekly UNIX file system backup, filesave, tapesave; filesave(IM) 

free: recover files from a backup tape frec(IM) 

spare: replace a bad sector with a spare one spare(8) 

banner: make posters banner(l) 

termcap: terminal capability data base termcap(5) 

convert between long integer and base-64 ASCII string /164a: a641(3C) 

oriented (visual) display editor based on ex vi: screen vi(1) 

portions of pathnames basename, dirname: deliver ........ basename(l) 

arithmetic language be: arbitrary-precision bc(1) 

system initialization/ bre, bcheckrc, rc , powerfail: brc(IM) 

bcopy: interactive block copy bcopy(IM) 

files bdiff: file comparator for large .. bdiff(l) 

cb: C program beautifier cb(1) 

jh , ji, jn, yO, yl, yn: Bessel functions bessel(3M) 

bfs: big file scanner bfs(1) 

fread, fwrite: binary input/output fread(3S) 

bsearch: binary search bsearch(3C) 

tsearch, tdelete, twalk: manage binary search trees tsearch(3C) 

b j : the game of black jack bj(6) 

b j : the game of black jack bj(6) 

sync: update the super block sync(l) 

fsba: file system block analyzer fsba(IM) 

bcopy: interactive block copy bcopy(IM) 

sum: print checksum and block count of a file sum(1) 

df: report number of free disk blocks df(1M) 

system initialization shell/ bre , bcheckrc, rc , powerfail: brc(IM) 

space allocation brk, sbrk: change data segment brk(2) 

modest-sized programs bs: a compiler/interpreter for .... bs( 1 ) 

bsearch: binary search bsearch(3C) 

stdio: standard buffered input/output package stdio(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

mknod : build special file mknod(IM) 

swab: swap bytes swab(3C) 
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cc- C compiler cc(1) 

cflow: generate C flow graph cflow(l) 

cpp: the C language preprocessor . . cpp(1) 

cb : C program beautifier cb(l) 

lint: a C program checker lint(1) 

cxref: generate C program cross-reference ......... cxref(l) 

cal: print calendar cal(1) 

dc: desk calculator dc(1) 

cal: print calendar cal(1) 

calendar: reminder service calendar! 1) 

cu: call another UNIX SYSTEM V system . cu(1C) 

data returned by stat system call stat: stat(5) 

malloc, free, realloc, calloc: main memory allocator malloc(3C) 

intro: introduction to system calls and error numbers ........... intro(2) 

link and unlink system calls, link, unlink: exercise ..... link(IM) 

an LP line printer lp, cancel: send/cancel requests to ... lp(1) 

termcap: terminal capability data base termcap{5) 

asa : interpret ASA carriage control characters asa(1) 

text editor (variant of ex for casual users) edit: edit(1) 

cat: concatenate and print files .. cat(1) 
cat: phototypesetter interface .... cat(7) 

cb: C program beautifier cb(1) 

cc~ C compiler cc(1) 

cd : change working directory cd(l) 

remainder, absolute value./ floor, ceil, fmod , fabs: floor, ceiling, . floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute/ floor! 3M) 

cflow: generate C flow graph cflow(l) 

pipe: create an interprocess channel pipe(2) 

ungetc: push character back into input stream .. ungetc(3S) 

neqn eqnchar : special character definitions for eqn and . eqnchar(5) 

cuserid: get character login name of the user .. cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from stream getc(3S) 

putc, putchar, fputc, putw: put character or word on a stream ..... putc(3S) 

ascii: map of ASCII character set ascii(5) 

tr : translate characters tr(1) 

interpret ASA carriage control characters asa: asa(1) 

iscntrl, isascii: classify characters /isprint, isgraph, ..... ctype(3C) 

__tolower , toascii: translate characters /tolower, _toupper, .... conv(3C) 

lastlogin, monacct, nulladm,/ chargefee, ckpacct, dodisk, acctsh(IM) 

chdir: change working directory ... chdir(2) 

/dfsck: file system consistency check and interactive repair fsck(IM) 

checking procedure. checkall: faster file system checkall(IM) 

text for troff cw, checkcw: prepare constant-width ... cw( 1 ) 

for nroff or troff eqn, neqn, checkeq: format mathematical text . eqn(1) 

lint: a C program checker lint(1) 

grpck: password/group file checkers, pwck, pwck(IM) 

checkall: faster file system checking procedure checkall(IM) 

copy file systems with label checking, volcopy, labelit: volcopy(IM) 

copy file systems with label checking, volcopy, labelit: volcopy . 1m. old 

processed by fsck checklist: list of file systems ... checklist^) 
formatted with the MM/ mm, osdd, checkmm: print/check documents .... mm(1) 

file sum: print checksum and block count of a sum(1) 
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chess: the game of chess chess(6) 

chess: the game of chess chess(6) 

chown, chgrp: change owner or group chownCl) 

times: get process and child process times times(2) 

terminate wait: wait for child process to stop or wait(2) 

chmod : change mode chmod(l) 

chmod : change mode of file chmod(P) 

a file chown: change owner and group of .. chown(H) 

group chown, chgrp: change owner or chown( 1 ) 

for a command. chroot: change root directory chroot(IM) 

chroot: change root directory chroot(2) 

monacct, nulladm,/ chargefee, ckpacct, dodisk, lastlogin acctsh(IM) 

isgraph, iscntrl, isascii; classify characters /isprint, ctype(3C) 

uuclean: uucp spool directory clean-up uuclean(IM) 

clri: clear i-node clri(IM) 

inquiries ferror, feof, clearerr, fileno: stream status ... ferror(3S) 

alarm: set a process’s alarm clock alarm(?) 

cron: clock daemon cron(iM) 

clock: report CPU time used clock(3C) 

ldclose, ldaclose: close a common object file ldclose(3X) 

close: close a file descriptor close(2) 

close: close a file descriptor .... close(2) 

fclose, fflush: close or flush a stream fclose(3S) 

clri: clear i-node clri(IM) 

cmp: compare two files cmp(1) 

/idint, real, float, sngl, dble, cmplx, dcmplx , ichar , char:/ ftype(3F) 

col: filter reverse line- feeds .... col(1) 

common to two sorted files comm: select or reject lines comm(l) 

system: issue a shell command system(3S) 

test: condition evaluation command test(l) 

time: time a command time(l) 

nice: run a command at low priority nice(l) 

change root directory for a command, chroot: chroot(IM) 

env : set environment for command execution env(1) 

uux : unix to unix command execution uux(IG) 

quits nohup: run a command immune to hangups and nohup(l) 

getopt: parse command options getopt(l) 

/shell, the standard/restr icted command programming language sh(1) 

system activity timex: time a command; report process data and .. timex(l) 

per-process/ acctcms: command summary from acctcms(IM) 

argument list(s) and execute command xargs: construct xargs(l) 

install: install commands install(IM) 

mk: how to remake the system and commands mk(8) 

programs intro: introduction to commands and application introO) 

/to system maintenance commands and application/ intro(IM) 

and miscellaneous accounting commands, /of accounting acct(IM) 

ar : common archive file format ar(4) 

as- common assembler as(1) 

output a. out: common assembler and link editor .. a.out(4) 

ldclose, ldaclose: close a common object file ldclose(3X) 

/section header of a common object file ldshread(3X' 

linenum: line number entries in a common object file linenum(4) 
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nm : print name list of common object file nmCl) 

scnhdr: section header for a common object file scnhdr(M) 

routines Idfcn: common object file access ;.. ldfcn(M) 

Idopen, ldaopen: open a common object file for reading .... ldopen(3X) 

/line number entries of a common object file function ldlread(3X) 

read the file header of a common object file ldfhread; ldfhread(3X) 

seek to the symbol table of a common object file ldtbseek: ...... ldtbseek(3X) 

indexed symbol table entry of a common object file /read an ldtbread (3X) 

relocation information for a common object file reloc: ......... reloc(4) 

entries of a section of a common object file /relocation .... ldrseek(3X) 

to the optional file header of a common object file /seek ldohseek(3X) 

to an indexed/named section of a common object file /seek ldsseek(3X) 

number entries of a section of a common object file /seek to line .. ldlseek(3X) 

format svms: common object file symbol table ... syms(M) 

of a symbol table entry of a common object file /the index ldtbindex(3X) 

filehdr: file header for common object files filehdr(M) 

Id: link editor for common object files ld(1) 

size: print section sizes of common object files sized ) 

comm: select or reject lines common to two sorted files comm(l) 

ipcs: report inter-process communication facilities status ... ipcsO) 

stdipc: standard interprocess communication package stdipc(3C) 

diff: differential file comparator diff(1) 

bdiff; file comparator for large files bdiff(i) 

cmp: compare two files cmp(l) 

diff3; 3-way differential file comparison diff3(1) 

dircmp: directory comparison . dircmp(l) 

regcmp: regular expression compile regcmp(l) 

expression regcmp, regex: compile and execute a regular ..... regcmp(3X) 

regexp: regular expression compile and match routines regexp(5) 

cc- C compiler cc(1) 

yacc : yet another compiler-compiler yacc(l) 

modest-sized programs bs: a compiler/interpreter for bs(l) 

erf, erfc: error function and complementary error function erf(3H) 

wait: await completion of process ............. waitO) 

pack, peat, unpack: compress and expand files packO ) 

table entry of a/ ldtbindex: compute the index of a symbol ..... Id tbindex(3X) 

cat: concatenate and print files cat(1) 

synchronous printer scat: concatenate and print files on .... scat(1) 

test: condition evaluation command test(l) 

config: configure UNIX SYSTEM V. .. config ,68( 1M) 

system, lpadmin: configure the LP spooling lpadrain(IM) 

config: configure UNIX SYSTEM V config. 68(1M) 

fwtmp, wtmpfix: manipulate connect accounting records fwtmp(IM) 

an out-going terminal line connection dial: establish dial(3C) 

acctconl, acctcon2: connect-time accounting acctcon(IM) 

fsck, dfsck: file system consistency check and/ fsck(IM) 

report and interactive status console rjestat: RJE status rjestat(IC) 

cw, checkcw: prepare constant-width text for troff cw( 1 ) 

mkfs: construct a file system mkfs(IM) 

execute command xargs: construct argument list(s) and .... xargs(l) 

remove nroff/troff, tbl , and eqn constructs deroff: deroff(l) 

Is: list contents of directories ls(1) 
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csplit: context split .... csplit(l) 

fcntl: file control fcntl(2) 

vc: version control vc(1) 

asa : interpret ASA carriage control characters asa(1) 

ioctl: control device ioctl(2) 

init, telinit: process control initialization init(IM) 

msgctl: message control operations msgctl(2) 

semctl: semaphore control operations semctl(2) 

shmctl: shared memory control operations shmctl(2) 

fcntl: file control options fcntl(5) 

uucp status inquiry and job control uustat: uustat(IC) 

tty: controlling terminal interface .... tty(7) 

term: conventional names for terminals .. term(5) 

units: conversion program units(l) 

dd : convert and copy a file dd(1) 

floating-point number atof: convert ASCII string to atof(3C) 

and long integers 13tol, ltol3: convert between 3-byte integers ... 13tol(3C) 

base-64 ASCII/ a641, 164a: convert between long integer and .. a641(3C) 

/gmtime, asctime, tzset: convert date and time to string ... ctime(3C) 

and VAX-11/780/ fscv : convert files between M68000 fscv(IM) 

string ecvt, fcvt, gcvt: convert floating-point number to .. ecvt(3C) 

scanf, fscanf, sscanf: convert formatted input scanf(3S) 

strtol, atol , atoi: convert string to integer strtol(3C) 

bcopy: interactive block copy bcopy(IM) 

uucp, uulog, uunarae: unix to unix copy uucp(IC) 

dd ; convert and copy a file dd(1) 

cpio: copy file archives in and out cpio(l) 

access time, dcopy: copy file systems for optimal ..... dcopy(IM) 

checking, volcopy, labelit: copy file systems with label volcopy(IM) 

checking, volcopy, labelit: copy file systems with label volcopy . 1m. old 

cp, In, mv: copy, link or move files cp(1) 

UNTX System-to-UNIX System file copy uuto, uupick: public uuto(IC) 

core: format of core image file ... core(4) 

core: format of core image file core(4) 

mein, kmem: core memory mem(7) 

atan2: trigonometric/ sin, cos, tan, asin, acos, atan, trig(3M) 

sinh, cosh, tanh: hyperbolic functions .. sinh(3M) 

wc : word count wed) 

sum: print checksum and block count of a file sum(l) 

files cp, In, mv : copy, link or move .... cp(1) 

cpio: format of cpio archive cpio(4) 

out cpio: copy file archives in and ... cpio(l) 

cpio: format of cpio archive ...... cpio(4) 

cpp: the C language preprocessor .. cpp(1) 

clock: report CPU time used clock(3C) 

craps: the game of craps craps(6) 

craps: the game of craps craps(6) 

crash: examine system images crash(IM) 

crashes crash: what to do when the system . crash.m68(8) 

crash: what to do when the system crashes crash. m68(8) 

rewrite an existing one creat: create a new file or ....... creat(2) 

file tmpnam, tempnam: create a name for a temporary tmpnam(3S) 
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existing one creat: create a new file or rewrite an ... creat(2) 

fork: create a new process fork(2) 

tmpfile: create a temporary file tmpfile(3S) 

pipe: create an interprocess channel .... pipe(2) 

umask: set and get file creation mask uraask(P) 

cron: clock daemon cron(IM) 

cxref: generate C program cross-reference cxref(l) 

DES encryption crypt, setkey, encrypt: generate .. crypt(3C) 

csplit: context split csplit(l) 

terminal ct: spawn getty to a remote ct(1C) 

terminal ctermid ; generate filename for .... ctermid(3S) 

asctime, tzset: convert date and/ ctime, localtime, gmtime, ctime(3C) 

cu: call another UNIX SYSTEM V system cu(1C) 

ttt, cubic: tic-tac-toe ttt(6) 

uname: get name of current operating system uname(2) 

uname: print name of current UNIX System uname(l) 

the slot in the utmp file of the current user ttyslot: find ttyslot(3C) 

getcwd : get pathname of current working directory getcwd(3C) 

of the user cuserid; get character login name . cuserid(3S) 

each line of a file cut: cut out selected fields of ... cut(1) 

line of a file cut: cut out selected fields of each ... cut(1) 

constant-width text for troff cw, checkcw: prepare cw(1) 

cross-reference cxref: generate C program cxref(l) 

cron: clock daemon cron(IM) 

errdemon: error-logging daemon errdemon(IM) 

lpd: line printer daemon lpd(IC) 

terminate the error-logging daemon, errstop: errstop(IM) 

runacct: run daily accounting runacctdM) 

backup, filesave, tapesave: daily/weekly UNIX file system filesave(IM) 

/300s: handle special functions of DASI 300 and 300s terminals 300(1) 

handle special functions of the DASI 450 terminal 450: 450(1) 

prof: display profile data prof(l) 

time a command; report process data and system activity timex: ... timex(l) 

termcap: terminal capability data base ...: termcap(5) 

sputl, sgetl : access long integer data in a machine independent/ .... sputl(3X) 

plock: lock process, text, or data in memory plock(2) 

call stat: data returned by stat system stat(5) 

brk, sbrk: change data segment space allocation brk(2) 

types: primitive system data types types(5) 

join: relational database operator join(l) 

date: print and set the date dated ) 

date: print and set the date date. 1. old 

/gmtime, asctime, tzset: convert date and time to string ctime(3C) 

date: print and set the date dated) 

date; print and set the date date. 1. old 

/ifix, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char:/ ftype(3F) 

dc: desk calculator dc(1) 

/real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit/ .... ftype(3F) 

optimal access time. dcopy: copy file systems for dcopy(IM) 

dd : convert and copy a file dd(1) 

fsdb, fsdblb: file system debugger fsdb(IM) 

sdb: symbolic debugger sdb(1) 
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sysdef; system definition. . . sysdef(IM) 

eqnchar: special character definitions for eqn .and neqn eqnchar(5) 

basename, dirname: deliver portions of pathnames basename( 1 ) 

tail: deliver the last part of a file ... tail(l) 

mesg: permit or deny messages mesg(l) 

and eqn constructs deroff: remove nr off/troff, tbl, .. deroff(l) 

crypt, setkey, encrypt: generate DES encryption crypt(3C) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator dc(1) 

file access; determine accessibility of a access(2) 

file; determine file type filed) 

ioctl: control device ioctl(2) 

master: master device information table master ,dec(4) 

devnm: device name. devnm(IM) 

devnm: device name devnm(IM) 

blocks. df: report number of free disk .... df(1M) 
check and interactive/ fsck, dfsck: file system consistency .... fsck(IM) 

terminal line connection dial: establish an out-going dial(3C) 

comparator diff; differential file diff(1) 

comparison diff3: 3-way differential file .... diff3(1) 

sdiff: side-by-side difference program sdiff(l) 

diffmk: mark differences between files diffmk(l) 

diff: differential file comparator ...... diff(l) 

diff3: 3-way differential file comparison diff3(1) 

files diffmk: mark differences between .. diffmk(l) 

dir: format of directories dir(M) 

dircrap: directory comparison dircmp(l) 

dir: format of directories dir(4) 

Is: list contents of directories ls(1) 

rm, rmdir: remove files or directories rm(1) 

cd : change working directory cd(1) 

chdir: change working directory chdir(2) 

chroot: change root directory chroot(2) 

mkdir: make a directory mkdir(l) 

mvdir: move a directory mvdir(IM) 

uuclean: uucp spool directory clean-up uuclean(IM) 

dircmp: directory comparison dircrap(l) 

unlink: remove directory entry unlink(2) 

chroot: change root directory for a command chroot(IM) 

get pathname of current working directory getcwd : getcwd(3C) 

pwd : working directory name pwd(1) 

ordinary file mknod : make a directory, or a special or mknod(2) 

pathnames basename, dirname: deliver portions of basename(l) 

printers enable, disable: enable/disable LP ........ enabled ) 

acct: enable or disable process accounting acct(2) 

type, modes, speed , and line discipline, /set terminal getty(IM) 

sadp; disk access profiler sadpd) 

df: report number of free disk blocks dfdM) 

du: summarize disk usage dud) 

mount, umount: mount and dismount file system mount(IH) 

vi: screen oriented (visual) display editor based on ex vi(1) 
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prof: display profile data prof(1) 

hvpot: Euclidean distance function . . hypot(3M) 

/lcong48: generate uniformly distributed pseudo-random/ drand48(3C) 

mm, osdd, checkmm: print/check documents formatted with the MM/ .. mm(1) 

MM macro package for formatting documents mm: the mm(5) 

macro package for formatting documents /the OSDD adapter mosd(5) 

slides mmt, mvt: typeset documents, viewgraphs, and mmt( 1 ) 

nulladm,/ chargefee, ckpacct, dodisk, lastlogin, monacct, acctsh(IM) 

whodo: who is doing what whodo(IM) 

reversi : a game of dramatic reversals .. reversi(6) 

nrand48, mrand48, jrand48,/ drand48, erand48, lrand48, drand48(3C) 

arithmetic: provide drill in number facts ar ithmetic(6) 

trace: event-tracing driver trace(7) 

du: summarize disk usage du(1) 

od : octal dump od(1) 

object file dump: dump selected parts of an ... dump(1) 

extract error records from dump, errdead: errdead(lM) 

file dump: dump selected parts of an object dump(l) 

descriptor dup: duplicate an open file dup(2) 

descriptor dup*. duplicate an open file dup(2) 

echo: echo arguments echo(l) 

echo: echo arguments echo(1) 

floating-point number to string ecvt, fcvt, gcvt: convert ecvt(3C) 

ed t red: text editor ed(1) 

end, etext, edata: last locations in program .. end(3C) 

for casual users) edit: text editor (variant of ex .. edit(1) 

ed , red: text editor ed(1) 

ex: text editor ex(1) 

sed : stream editor sed(1) 

screen oriented (visual) display editor based on ex vi: vi(1) 

id: link editor for common object files .... ldd) 

common assembler and link editor output a. out: a. out (4) 

users) edit: text editor (variant of ex for casual .. edit(l) 

effective user, real group, and effective group IDs /real user, ... getuid(2) 

/getgid, getegid: get real user, effective user, real group, and/ .. getuid(2) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

pattern grep, egrep, fgrep: search a file for a . grep(1) 

LP printers enable, disable: enable/disable ... enabled ) 

accounting acct: enable or disable process acct(2) 

enable, disable: enable/disable LP printers enabled ) 

crypt, setkey, encrypt: generate DES encryption .. crvpt(3C) 

setkey, encrypt: generate DES encryption crypt, crypt(3C) 

makekey: generate encryption key makekey(l) 

in program end, etext, edata: last locations . end (3c) 

getgrgid, getgrnam, setgrent, endgrent: obtain getgrent, ........ getgrent(3C) 

/getpwuid, getpwnam, setpwent, endpwent: get 'password file/ getpwent(3C) 

/getutline, pututline, setutent, endutent, utmpname: access utmp/ .. getut(3C) 

nlist: get entries from name list nlist(3C) 

linenum: line number entries in a common object file ... linenum(4) 

man, manprog: print entries in this manual man(1) 

man: macros for formatting entries in this manual man(5) 

/ldlitem: manipulate line number entries of a common object file/ .. ldlread(3X) 
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/ldnlseek: seek to line number entries of a section of a common/ . ldlseek(3X) 

/ldnrseek: seek to relocation entries of a section of a common/ . ldrseek(3X) 

putpwent; write password file entry putpwent(3C) 

unlink: remove directory entry unlink(2) 

utrnp, wtmp: utmp and wtmp entry formats utmp(U) 

endpwent: get password file entry /getpwnam, setpwent, getpwent(3C) 

/the index of a symbol table entry of a common object file ldtbindex(3X) 

/read an indexed symbol table entry of a common object file ldtbread(3X) 

utmpname: access utmp file entry /setutent. endutent, getut(3C) 

execution env: set environment for command env(1) 

environ: user environment environ^) 

environ: user environment environ(5) 

profile: setting up an environment at login time profile(4) 

execution env: set environment for command env(1) 

getenv : return value for environment name getenv(3C) 

sky: obtain ephemerides sky(6) 

special character definitions for eqn and neqn eqnchar: eqnchar(5) 

remove nroff/troff, tbl, and eqn constructs deroff: deroff(l) 

mathematical text for nroff or/ eqn, neqn, checkeq: format eqn(1) 

definitions for eqn and neqn eqnchar: special character eqnchar(5) 

mrand48, jrand48,/ drand48, erand48, lrand48, nrand48, . drand48(3C) 

complementary error function erf, erfc: error function and ..... erf(3M) 

complementary error/ erf, erfc: error function and erf(3M) 

err: error-logging interface err(7) 

from dump. errdead: extract error records .... errdead(lM) 

daemon. errdemon: error-logging errdemon(1M 

errfile: error-log file format .... errfile(4) 

system error messages perror, errno, svs_errlist, sys_nerr : perror(3C) 

error function erf, erfc: error function and complementary .. erf(3M) 

error function and complementary error function erf, erfc: erf(3M) 

sys_errlist, sys^nerr: system error messages perror, errno, ..... perror(3C) 

introduction to system calls and error numbers intro: intro(2) 

errdead; extract error records from dump errdead(IM) 

matherr: error-handling function ........... matherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdemon(IH) 

errstop: terminate the error-logging daemon. errstop(IM) 

err: error-logging interface err( 7) 

process a report of logged errors, errpt: errpt(IM) 

spellin, hashcheck: find spelling errors spell, hashmake, spell(l) 

logged errors. errpt: process a report of errpt(IM) 

error-logging daemon. errstop: terminate the errstop(IM) 

line connection dial: establish an out-going terminal ... dial(3C) 

setmnt: establish mount table setmnt(IM) 

program end, etext, edata: last locations in ... end(3C) 

hypot: Euclidean distance function hypot(3M) 

expression expr : evaluate arguments as an exprCl) 

test: condition evaluation command test(1) 

trace: event-tracing driver trace(7) 

edit: text editor (variant of ex for casual users) edit(1) 

ex: text editor ex(1) 

(visual) display editor based on ex vi: screen oriented vi(1) 
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crash: examine system images crashOM) 

execlp, execvp: execute a file execl, execv, execle, execve, ..... exec(2) 

execute a file execl, execv, execle, execve, execlp, execvp: ... exec(2) 

execl, execv, execle, execve, execlp, execvp: execute a file .... exec(2) 

execle, execve, execlp, execvp: execute a file execl, execv, ...... exec(2) 

regcmp, regex: compile and execute a regular expression regcmp(3X) 

construct argument list(s) and execute command xargs: xargs(l) 

env : set environment for command execution env(1) 

uux : unix to unix command execution uux(IC) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleep(3C) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profil(2) 

execvp: execute a file execl, execv, execle, execve, execlp, .... exec(2) 

file execl, execv, execle, execve, execlp, execvp: execute a . exec(2) 

execv, execle, execve, execlp, execvp: execute a file execl, exec(2) 

system calls, link, unlink: exercise link and unlink link(IM) 

create a new file or rewrite an existing one creat; creat(2) 

exit, __exit: terminate process .... exit(2) 

exit, __exit: terminate process ; exit(2) 

exponential, logarithm, power,/ exp, log, loglO, pow, sqrt: exp(3M) 

pack, peat, unpack: compress and expand files pack(1) 

> exp, log, loglO, pow, sqrt: exponential, logarithm, power,/ ... exp(3M) 

expression expr: evaluate arguments as an .... exprO) 

expr: evaluate arguments as an expression expr(1) 

regcmp: regular expression compile regcmpC 1 ) 

routines regexp: regular expression compile and match regexp(5) 

compile and execute a regular expression regcmp, regex: regcmp(3X) 

greek: graphics for the extended TTY-37 type-box greek(5) 

dump, errdead; extract error records from errdead(IM) 

fsplit: split f77. ratfor, or efl files fsplit(l) 

absolute/ floor, ceil, fmod , fabs: floor, ceiling, remainder, .. floor(3M) 

factor: factor a number factorO) 

factor: factor a number factor(l) 

true, false: provide truth values trued ) 

data in a machine independent fashion, /access long integer sputl(3X) 

fine: fast incremental backup finc(IM) 

procedure, checkall : faster file system checking checkall(IM) 

abort: generate an TOT fault abort(3C) 

stream fclose, f flush: close or flush a .. fclose(3S) 

fcntl: file control fcntl(2) 

fcntl: file control options fcntl (5) 

floating-point number to/ ecvt, fevt, gevt: convert ecvt(3C) 

fopen, freopen, fdopen: open a stream fopen(3S) 

status inquiries ferror, feof, clearerr, fileno: stream .... ferror(3S) 

stream status inquiries ferror, feof, clearerr, fileno: ... ferror(3S) 

statistics for a file system. ff: list file names and ff(1M) 

fclose, fflush: close or flush a stream ... fclose(3S) 

word from stream getc , getchar, fgetc, getw: get character or getc(3S) 

stream gets, fgets: get a string from a gets(3S) 

pattern grep, egrep, fgrep: search a file for a grepd ) 

chmod: change mode of file chmod(2) 
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core: format of core image file . .. core(4) 

dd : convert and copy a file dd(1) 

group: group file group(4) 

issue: issue identification file issued) 

link: link to a file link(2) 

mknod : build special file mknod(IM) 

null: the null file null(7) 

passwd; password file passwd(U) 

read: read from file read(2) 

tail: deliver the last part of a file tail(1) 

tmpfile: create a temporary file tmpfile(3S) 

uniq: report repeated lines in a file uniq(1) 

write: write on a file .. write(?) 

determine accessibility of a file access: access (?) 

times utime: set file access and modification utime(2) 

ldfcn: common object file access routines ldfcn(4) 

tar: tape file archiver tar(1) 

cpio: copy file archives in and out cpioO) 

pwck, grpck: password/group file checkers pwck(IM) 

change owner and group of a file chown: chown(2) 

diff: differential file comparator diff(1) 

bdiff: file comparator for large files ... bdiff(l) 

diff3: 3-way differential file comparison diff3(1) 

fcntl: file control fcntl(2) 

fcntl: file control options fcntl(5) 

public UNIX System-to~UNIX System file copy uuto, uupick: uuto(IC) 

umask: set and get file creation mask umask(2) 

selected fields of each line of a file cut: cut out cutO) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

file: determine file type filed ) 

dump selected parts of an object file dump: dump(l) 

putpwent: write password file entry putpwent(3C) 

setpwent. endpwent: get password file entry /getpwuid, getpwnam, ... getpwent(3C) 

endutent, utmpname: access utmp file entry /pututline, setutent, .. getut(3C) 

execve, execlp, execvp: execute a file execl, execv, execle, execC?) 

grep, egrep, fgrep: search a file for a pattern grep(l) 

ldaopen: open a common object file for reading ldopen, ldopen(3X) 

acct: per-process accounting file format acct(4) 

ar: common archive file format ar(4) 

errfile: error-log file format errfile(4) 

intro: introduction to file formats intro(U) 

number entries of a common object file function /manipulate line .... ldlread(3X) 

files filehdr: file header for common object filehdr(4) 

file ldfhread: read the file header of a common object .... ldfhread(3X) 

ldohseek: seek to the optional file header of a common object/ ... ldohseek(3X) 

3plit: split a file into pieces split(l) 

header of a member of an archive file ldahread: read the archive ... ldahread(3X) 

ldaclose: close a common object file ldclose, ldclose(3X) 

file header of a common object file ldfhread; read the ldfhread(3X) 

retrieve symbol name for object file ldgetname; ldgetname(3X'> 

symbol table of a common object file ldtbseek: seek to the ldtbseek(3X 
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number entries in a common object file linenum: line ......... linenum(4) 

or a special or ordinary file mknod : make a directory, mknod(p) 

a file system, ff: list file names and statistics for f f ( 1 M ) 

change the format of a text file newform: newform(l) 

print name list of common object file nm : nm(1) 

/find the slot in the utmp file of the current user .......... ttyslot(3C) 

creat: create a new file or rewrite an existing one ... creat(2) 

lseek: move read/write file pointer lseek(2) 

rewind, ftell: reposition a file pointer in a stream fseek, ... fseek(3?) 

table entry of a common object file /read an indexed symbol ldtbread(3X) 

section header of a common object file /read an indexed/named ldshread(3X) 

information for a common object file reloc: relocation reloc(4) 

files or subsequent lines of one file /same lines of several paste(l) 

bfs: big file scanner bfsO) 

header for a common object file scnhdr: section scnhdr(4) 

section of a common object file /seek to an indexed/named .... ldsseek(3X) 

of a section of a common object file /seek to relocation entries .. ldrseek(3X) 

file header of a common object file /seek to the optional ldohseek(3X) 

number information from an object file /strip symbol and line strip(l) 

checksum and block count of a file sum: print sum(1) 

svms: common object file symbol table format syms(4) 

mkf s : construct a file system mkfsOM) 

mount: mount a file system mount(2) 

umount: unmount a file system umount(2) 

tapesave: dailv/weekly UNIX file system backup, filesave, filesave(IM) 

fsba: file system block analyzer fsba(IM) 

procedure, checkall: faster file system checking checkall(IM) 

and interactive/ fsck, dfsck: file system consistency check ..... fsck(IM) 

fsdb, fsdblb: file system debugger fsdb(IM) 

names and statistics for a file system, ff: list file ff(1M) 

volume file system: format of system fs(4) 

umount: mount and dismount file system, mount, mount(IM) 

ustat: get file system statistics ustat(2) 

mnttab: mounted file system table rnnttab(4) 

access time, dcopv: copy file systems for optimal dcopy(IM) 

checklist: list of file systems processed by fsck .... checklists) 

volcopy, labelit: copy file systems with label/ volcopy(IM) 

volcopy, labelit: copy file systems with label/ volcopy . 1m. old 

table entry of a common object file /the index of a symbol ldtbindex(3X) 

create a name for a temporary file tmpnam, tempnam: tmpnam(3S) 

of a section of a common object file /to line number entries ldlseek(3X) 

and modification times of a file touch: update access touchCl) 

ftw: walk a file tree ftw(3C) 

file: determine file type file(1 ) 

umask: set file-creation mode mask umaskd ) 

object files filehdr: file header for common ... filehdr(4) 

mktemp: make a unique filename mktemp(3C) 

ctermid : generate filename for terminal ctermid(3S) 

ferror, feof, clearerr, fileno: stream status inquiries ... ferror(3S) 

bdiff: file comparator for large files bdiff(l) 

cat: concatenate and print files cat(1) 

cmp: compare two files cmpd) 
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cp, In, tnv : copy, link or move files cp(1) 

diffmk: mark differences between files diffmk(l) 

find: find files findd) 

intro: introduction to special files intro(T) 

Id; link editor for common object files ld(1) 

pr : print files pr(1) 

sort: sort and/or merge files sortd ) 

and print process accounting file(s) acctcom: search acctcomd) 

merge or add total accounting files, acctmerg: acctmerg(IM) 

VAX-1 1/780/ fscv : convert files between M68000 and fscv(IM) 

reject lines common to two sorted files comm: select or comm(1) 

file header for common object files filehdr: filehdrd) 

free: recover files from a backup tape frec(IM) 

format specification in text files fspec: fspecd) 

split f77, ratfor, or efl files fsplit: fsplit(l) 

scat: concatenate and print files on synchronous printer scat(1) 

rm, rmdir: remove files or directories rm(1) 

/merge same lines of several files or subsequent lines of one/ . pasted ) 

peat, unpack: compress and expand files pack, pack(1) 

section sizes of common object files size: print sized) 

daily/weeklv UNIX file system/ filesave, tapesave: filesave(IM) 

greek: select terminal filter greekCl ) 

nl : line numbering filter nl(1) 

col: filter reverse line- feeds cold) 

fine: fast incremental backup finc(IM) 

find: find files find(1) 

find; find files find(1) 

hyphen: find hyphenated words hyphend) 

ttyname, isatty: find name of a terminal ttyname(3C) 

object library lorder: find ordering relation for an ..... lorder(l) 

hashmake, spellin, hashcheck: find spelling errors spell, spelld) 

the current user ttyslot: find the slot in the utmp file of . ttyslot(3C) 

tee: pipe fitting teed) 

ichar,/ int, ifix, idint, real, float, sngl, dble, cmplx , dcmplx, . ftype(3F) 

atof: convert ASCII string to floating-point number atof(3C) 

ecvt, fevt, gevt: convert floating-point number to string ... ecvt(3C) 

ldexp, modf: manipulate parts of floating-point numbers frexp, ..... frexp(3C) 

ceiling, remainder, absolute/ floor, ceil, fmod , fabs; floor, ... floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder,/ floor(3M) 

cflow: generate C flow graph cflow(l) 

fclose, fflush: close or flush a stream fclose(3S) 

remainder, absolute/ floor, ceil, fmod, fabs: floor, ceiling, floor(3M) 

stream fopen , freopen, fdopen; open a .... fopen(3S) 

fork; create a new process fork(2) 

acct: per-process accounting file format acct(M) 

ar; common archive file format ar(4) 

errfile: error-log file format errfiled) 

nroff or/ eqn, neqn, checkeq: format mathematical text for eqn(1 ) 

newform: change the format of a text file newformCD 

inode: format of an inode inode(4) 

core: format of core image file core(U) 

cpio: format of cpio archive cpiod) 
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dir: format of directories dir(M) 

file system: format of system volume fsS) 

files fspec: format specification in text fspec(4) 

common object file symbol table format syms: syms(4) 

tbl: format tables for nroff or troff .. tbl Cl) 

nroff: format text nroff(l) 

intro: introduction to file formats introS) 

utmp, wtmp: utmp and wtmp entry formats utmp(4) 

scanf, fscanf, sscanf: convert formatted input scanf(3$) 

printf, fprintf, sprintf: print formatted output printf(3S) 

/checkmm: print/check documents formatted with the MM macros . mm(1) 

mptx: the macro package for formatting a permuted index mptx(5) 

mm: the MM macro package for formatting documents mm(5) 

OSDD adapter macro package for formatting documents mosd : the .... mosd(5) 

manual man: macros for formatting entries in this man(5) 

output printf, fprintf, sprintf: print formatted . printf(35) 

word on a stream putc, putchar , f putc , putw: put character or putc(3S) 

puts, fputs: put a string on a stream ... puts(3S) 

input/output fread, fwrite: binary fread(3S) 

backup tape. free: recover files from a frec(IM) 

df; report number of free disk blocks df(lM) 

memory allocator malloc, free, realloc, calloc: main malloc(3C) 

fopen, freopen, fdopen: open a stream .... fopen(3S) 
parts of floating-point numbers frexp, ldexp, modf: manipulate .... frexp(3C) 

free: recover files from a backup tape frec(IM) 

gets, fgets: get a string from a stream gets(3S) 

and line number information from an object file /symbol strip(l) 

getopt: get option letter from argument vector getopt(3C) 

errdead; extract error records from dump errdead(IM) 

read: read from file read(2) 

ncheck: generate names from i-numbers ncheck(IM) 

nlist: get entries from name list nlist(3C) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

getw: get character or word from stream /getchar, fgetc, getc(3S) 

getpw: get name from UTD getpw(3C) 

analyzer. fsba: file system block fsba(IM) 

input scanf, fscanf, sscanf: convert formatted . scanf(3S) 

list of file systems processed by fsck checklist: checklists) 

consistency check and/ fsck, dfsck: file system fsck(IM) 

M68000 and VAX-1 1/780/ fsev : convert files between fscv(IM) 

debugger. fsdb, fsdblb: file system fsdb(IM) 

fsdb, fsdblb: file system debugger fsdb(IM) 

a file pointer in a stream fseek, rewind, ftell : reposition .. fseek(3S) 
text files fspec: format specification in .... fspec(U) 

efl files fsplit: split f77, ratfor, or fsplit(l) 

in a stream fseek, rewind, ftell: reposition a file pointer .. fseek(3S) 

ftw: walk a file tree ftw(3C) 

gamma: log gamma function gamma(3M) 

hypot: Euclidean distance function hypot(3M) 

matherr: error-handling function matherr(3M) 

' function erf, erfc: error function and complementary error .. erf(3M) 

J function and complementary error function erf, erfc: error erf(3M) 
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entries of a common object file function /manipulate line number .. ldlread(3X, 

jO, j 1 , jn, vO, yl, yn: Bessel functions * bessel(3M) 

sinh, cosh, tanh: hyperbolic functions sinh(3M) 

remainder, absolute value functions /fabs: floor, ceiling, . . floor(3M) 

300, 300s: handle special functions of DASI 300 and 300s/ ... 300(1) 

26? 1 -ser ies/ hp: handle special functions of HP 2640 and hp(l) 

terminal 450: handle special functions of the DASI 450 450(1) 

acos, atan, atan2: trigonometric functions sin, cos, tan, asin, .... trig(3M) 

logarithm, power, square root functions /sqrt: exponential, exp(3M) 

fread, fwrite: binary input/output fread(3S) 

connect accounting records. fwtmp, wtmpfix: manipulate fwtmp(IM) 

jotto: secret word game jotto(6) 

moo: guessing game moo(6) 

back: the game of backgammon back(6) 

b j : the game of black jack bj(6) 

chess: the game of chess chess(6) 

craps: the game of craps craps(6) 

reversi : a game of dramatic reversals reversi(6) 

wump: the game of hunt-the-wurapus wump(6) 

intro: introduction to games intro(6) 

gamma: log gamma function gamma(3M) 

gamma: log gamma function gamma(3M) 

number to string ecvt, fcvt, gcvt: convert floating-point ecvt(3C) 

maze: generate a maze maze(6) 

abort: generate an IOT fault abort(3C) 

cflow: generate C flow graph cflow(l) 

cross-reference cxref: generate C program ................ cxref(l) 

crypt, setkey, encrypt: generate DES encryption crypt(3C) 

makekey: generate encryption key makekey(l) 

ctermid: generate filename for terminal .... ctermid(3S) 

ncheck: generate names from i-numbers ncheck(IM) 

lexical tasks lex: generate programs for simple lex(1) 

/srand48, seed48, lcong48: generate uniformly distributed/ ... drand48(3C) 

rand, srand : simple random-number generator rand(3C) 

gets, fgets: get a string from a stream gets(3S) 

ulimit: get and set user limits ulimit(2) 

user cuserid: get character login name of the ... cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from/ getc(3S) 

nlist: get entries from name list nlist(3C) 

umask: set and get file creation mask umask(2) 

ustat: get file system statistics ustat(2) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

msgget: get message queue msgget(2) 

getpw : get name from UTD getpw(3C) 

system uname: get name of current operating uname(2) 

vector getopt: get option letter from argument ... getopt(3C) 

/getpwnam, setpwent, endpwent: get password file entry getpwent(3C) 

directory getcwd : get pathname of current working ... getcwd(3C) 

times times: get process and child process times(2) 

parent/ getpid , getpgrp, getppid: get process, process group, and ... getpid(2) 

getuid , geteuid, getgid, getegid: get real user, effective user,/ ... getuid(2) 
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semget: get set of semaphores semget(2) 

shmget: get shared memory segment shmget(2) 

tty: get the terminal's name ........... tty(1) 

time: get time time(2) 

character or word from stream getc , getchar, fgetc, getw: get ... getc(3S) 

character or word from/ getc, getchar, fgetc, getw: get getc(3S) 

working directory getcwd: get pathname of current ... getcwd(3C) 

user,/ getuid, geteuid, getgid, getegid: get real user, effective . getuid(2) 

environment name getenv : return value for getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid: get getuid(2) 

effective user,/ getuid, geteuid, getgid, getegid: get real user, ... getuid(2) 

setgrent, endgrent: obtain getgrent, getgrgid, getgrnam, getgrent(3C) 

endgrent: obtain getgrent, getgrgid, getgrnam, setgrent, getgrent(3C) 

obtain getgrent, getgrgid, getgrnam, setgrent, endgrent: getgrent(3C) 

getlogin: get login name getlogin(3C) 

argument vector getopt : get option letter from .... getopt(3C) 

getopt: parse command options getopt(l) 

getpass: read a password getpass(3C) 

process group, and/ getpid, getpgrp, getppid; get process, .... getpid(2) 

process, process group, and/ getpid, getpgrp, getppid: get getpid(2) 

group, and/ getpid, getpgrp, getppid: get process, process getpid(2) 

getpw: get name from UID getpw(3C) 

setpwent, endpwent: get password/ getpwent, getpwuid , getpwnam, getpwent(3C) 

password/ getpwent, getpwuid, getpwnam, setpwent, endpwent: get . getpwent(3C) 

endpwent: get password/ getpwent, getpwuid, getpwnam, setpwent, getpwent(3C) 

stream gets, fgets: get a string from a .. gets(3S) 

and terminal settings used by getty gettydefs: speed gettydefs(4 ) 

modes, speed, and line/ getty: set terminal type, getty(IM) 

ct: spawn getty to a remote terminal ct(1C) 

settings used by getty gettydefs: speed and terminal ..... gettydefs(4) 

get real user, effective user,/ getuid, geteuid, getgid, getegid: . getuid(?) 

pututline, setutent, endutent,/ getutent, getutid, getutline getut(3C) 

setutent, endutent,/ getutent, getutid, getutline, pututline, .... getut(3C) 

endutent,/ getutent, getutid, getutline, pututline, setutent, ... getut(3C) 

stream getc, getchar, fgetc, getw: get character or word from .. getc(3S) 

date and time/ ctime, localtime, gmtime, asctime, tzset: convert ... ctime(3C) 

setjmp, longjmp: non-local goto setjmp(3C) 

cflow: generate C flow graph cflow(l) 

sag: system activity graph sag(1) 

type-box greek: graphics for the extended TTY-37 .. greek(5) 

TTY-37 type-box greek: graphics for the extended .. greek(5) 

greek: select terminal filter greek(l) 

for a pattern grep, egrep, fgrep: search a file . grep(1) 

chown, chgrp: change owner or group chown(l) 

newgrp: log in to a new group newgrp(l) 

/real user, effective user, real group, and effective group IDs .... getuid(2) 

/getppid: get process, process group, and parent process IDs getpid(2) 

group: group file group(4) 

group: group file group(4) 

setpgrp: set process group ID setpgrp(2) 

setuid, setgid: set user and group IDs setuid(2) 

id: print user and group IDs and names id(l) 
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user, real group, and effective group IDs /real user, effective ... getuid(2) 

chown: change owner and group of a file chown(P) 

send a signal to a process or a group of processes kill: kill(2) 

maintain, update, and regenerate groups of programs make: make(1) 

checkers, pwck, grpck: password/group file pwck(IM) 

ssignal, gsignal: software signals ssignal(3C) 

hangman: guess the word hangman(6) 

moo: guessing game moo(6) 

300 and 300s/ 300, 300s: handle special functions of DASI .. 300(1) 

2640 and 2621-series/ hp: handle special functions of HP .... hp(1) 

DASI 450 terminal 450: handle special functions of the ... 450(1) 

hangman: guess the word hangman(6) 

nohup: run a command immune to hangups and quits nohup(l) 

hcreate, hdestroy: manage hash search tables hsearch, hsearch(3C) 

spell, hashmake, spell in, hashcheck: find spelling errors ... spell(l) 

find spelling errors spell, hashmake, spellin, hashcheck: ..... spell(l) 

search tables hsearch, hcreate, hdestroy: manage hash .... hsearch(3C) 

tables hsearch, hcreate, hdestroy: manage hash search ...... hsearch(3C) 

aouthdr: optional aout header aouthdr(4) 

scnhdr: section header for a common object file ... scnhdr(4) 

filehdr: file header for common object files .... filehdr(4) 

ldfhread; read the file header of a common object file .... ldfhread(3X) 

/seek to the optional file header of a common object file .... ldohseek(3X) 

/read an indexed/named section header of a common object file .... ldshread(3X) 

file ldahread : read the archive header of a member of an archive .. ldahread(3X) 

help: ask for help help(1) 

help: ask for help help(1) 

hp: handle special functions of HP 2640 and 2621 -series/ hp(1) 

HP 2640 and 2621-series/ hp: handle special functions of ... hp(1) 

manage hash search tables hsearch, hcreate, hdestroy: hsearch(3C) 

wump: the game of hunt-the-wumpus wump(6) 

sinh, cosh, tanh: hyperbolic functions sinh(3M) 

hyphen: find hyphenated words hyphen(l) 

hyphen: find hyphenated words hyphen(l) 

function hypot: Euclidean distance hypot(3M) 

setpgrp: set process group ID setpgrp(2) 

names id: print user and group IDs and .. id(i) 

semaphore set or shared memory id /remove a message queue, ipcrm(l) 

issue: issue identification file issue(4) 

cmplx, dcmplx, ichar,/ int , ifix, idint, real, float, sngl , dble, ... ftype(3F) 

id; print user and group IDs and names . id(l) 

process group, and parent process IDs /getppid; get process, getpid(2) 

real group, and effective group IDs /real user, effective user, ... getuid(2) 

setgid; set user and group IDs setuid, setuid(2) 

dble, cmplx, dcmplx, ichar,/ int, ifix, idint, real, float, sngl, ... ftype(3F) 

core: format of core image file core(4) 

crash: examine system images crash(IM) 

nohup: run a command immune to hangups and quits nohup(l) 

fine: fast incremental backup finc(IM) 

long integer data in a machine independent fashion, /access sputl(3X) 

/tgetstr, tgoto , tputs: terminal independent operation routines .... termcap(3) 

ptx: permuted index ptx(1) 
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package for formatting a permuted index mptx: the macro mptx(5) 

a common/ ldtbindex: compute the index of a symbol table entry of .. ldtbindex(3X) 

common object/ ldtbread; read an indexed symbol table entry of a ... ldtbread(3X) 

a/ ldshread, ldnshread : read an indexed/named section header of ... ldshread(3X) 

ldsseek, ldnsseek: seek to an indexed/named section of a/ ldsseek(3X) 

inittab: script for the init process inittab(4) 

initialization. init, telinit: process control .... init(IM) 

init, telinit: process control initialization init(IM) 

/rc , powerfail: system initialization shell scripts brc(IM) 

popen, pclose : initiate pipe to/ from a process ... popen(3$) 

process inittab: script for the init inittab(M) 

clri: clear i-node. ... clri(IM) 

inode: format of an inode inode(4) 

inode: format of an inode inode(4) 

fscanf, sscanf: convert formatted input scanf, scanf(3S) 

ungetc: push character back into input stream ungetc(3S) 

fread, fwrite: binary input/output fread(3S) 

stdio: standard buffered input/output package stdio(3S) 

clearerr, fileno: stream status inquiries ferror, feof, ferror(3S) 

uustat: uucp status inquiry and job control uustat(IC) 

install: install commands. installClM) 

install: install commands install(IM) 

sngl, dble, cmplx , dcmplx,/ int, ifix, idint, real, float, .... ftype(3F) 

abs: return integer absolute value abs(3C) 

a641, 164a: convert between long integer and base-64 ASCII string .. a641(3C) 

sputl, sgetl: access long integer data in a machine/ sputl(3X) 

atol , atoi: convert string to integer strtol, strtol(3C) 

/ltol3: convert between 3-byte integers and long integers 13tol(3C) 

between 3-byte integers and long integers 13tol, ltol3: convert .... 13tol(3C) 

bcopy: interactive block copy bcopy(IM) 

system consistency check and interactive repair, /file fsck(IM) 

rjestat: RJE status report and interactive status console rjestat(IC) 

cat: phototypesetter interface cat(7) 

err: error-logging interface err(7) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty(7) 

characters asa: interpret ASA carriage control .... asa(1) 

sno : SNOBOL interpreter sno(1) 

pipe: create an interprocess channel pipe(2) 

facilities status ipcs: report inter-process communication ipcs(1) 

package stdipc: standard interprocess communication stdipc(3C) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleep(3C) 

subroutines and libraries intro: introduction to intro(3) 

miscellaneous facilities intro: introduction to intro(5) 

and application programs intro: introduction to commands ... intro(l) 

formats intro: introduction to file intro(4) 

intro: introduction to games ...... intro(6) 

files intro: introduction to special .... intro(7) 

maintenance commands and/ intro: introduction to system ..... intro(IM) 

calls and error numbers intro: introduction to system intro(2) 

maintenance procedures intro: introduction to system ..... intro(8) 
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application programs intro: introduction to commands and intro(l) 

intro: introduction to file formats . intro(M) 

intro: introduction to games intro(6) 

facilities intro: introduction to miscellaneous intro(5) 

intro: introduction to special files intro(7) 

libraries intro: introduction to subroutines and ... intro(3) 

maintenance commands/ intro: introduction to system intro(IM) 

maintenance procedures intro: introduction to system intro(8) 

error numbers intro: introduction to system calls and .. intro(2) 

ncheck: generate names from i-numbers ncheckdM) 

ioctl: control device ioctl(2) 

abort: generate an IOT fault abort(3C) 

semaphore set or shared memory/ ipcrm: remove a message queue ipcrm(l) 

communication facilities status ipcs: report inter-process ipcs(1) 

/islower, isdigit, isxdigit, isalnum. isspace, ispunct./ ctype(3tion 

section header of a/ ldshread, ldnshread: read an indexed/named .. ldshread(3X) 

indexed/named section/ ldsseek, ldnsseek: seek to an ldsseek(3X) 

file header of a common object/ ldohseek: seek to the optional .... ldohseek(3X) 

object file for reading ldopen , ldaopen: open a common .... ldopen(3X) 

relocation entries of a section/ ldrseek, ldnrseek: seek to ldrseek(3X) 

indexed/named section header of/ ldshread, ldnshread: read an ldshread(3X) 

indexed/named section of a/ ldsseek, ldnsseek: seek to an ldsseek(3X) 

symbol table entry of a common/ ldtbindex: compute the index of a . ldtbindex(3X) 
table entry of a common object/ ldtbread: read an indexed symbol .. ldtbread(3X) 

table of a common object file ldtbseek: seek to the symbol ldtbseek(3X) 

getopt: get option letter from argument vector getopt(3C) 

lexical tasks lex: generate programs for simple . lex(1) 

lex: generate programs for simple lexical ta3ks lex(1) 

introduction to subroutines and libraries intro: intro(3) 

ordering relation for an object library lorder: find lorder(l) 

archives ar : archive and library maintainer for portable ... ard) 

ulimit: get and set user limits ulimit(2) 

line: read one line lined) 

establish an out-going terminal line connection dial: dial(3C) 

type, modes, speed, and line discipline, /set terminal .... getty(IM) 

object file linenum: line number entries in a common ... linenumd) 

/ldlinit, ldlitem: manipulate line number entries of a common/ .. ldlread(3X) 

of a/ ldlseek, ldnlseek: seek to line number entries of a section .. ldlseek(3X) 

object/ strip: strip symbol and line number information from an ... strip(l) 

nl : line numbering filter nlO) 

cut out selected fields of each line of a file cut: cut(1) 

lpd: line printer daemon lpd(IC) 

send/cancel requests to an LP line printer lp, cancel: lpd) 

lpr: line printer spooler lpr(1) 

line: read one line lined) 

1 search: linear search and update lsearch(3C) 

col: filter reverse line-feeds cold) 

common object file linenum: line number entries in a . linenumd) 
coram: select or reject lines common to two sorted files .. comind) 

uniq: report repeated lines in a file uniq(1) 

of several files or subsequent lines of one file /same lines pasted) 

subsequent/ paste: merge same lines of several files or pasted ) 
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link, unlink: exercise link and unlink system calls link(IM) 

files Id: link editor for common object Id ( 1 ) 

a. out: common assembler and link editor output a.out(4) 

link: link to a file link(2) 

cp, In, mv: copy, link or move files cp(1) 

link: link to a file link(?) 

and unlink system calls. link, unlink: exercise link link(IM) 

lint: a C program checker lint(1) 

nlist: get entries from name list nlist(3C) 

Is: list contents of directories ls(1) 

for a file system, ff: list file names and statistics .... ff(1M) 

nm : print name list of common object file nm(1) 

fsck checklist: list of file systems processed by . checklists) 

associated with a/ sparelist: list the spared sectors sparelist(8) 

xargs: construct argument list(s) and execute command xargs(l) 

cp, In, mv: copy, link or move files .. cp(1) 

tzset: convert date and/ ctime, localtime, gmtime, asctime, ctime(3C) 

end, etext, edata: last locations in program end(3C) 

memory plock: lock process, text, or data in .... plock(2) 

gamma: log gamma function gamma(3M) 

newgrp: log in to a new group newgrp(l) 

exponential, logarithm,/ exp, log, logic, pow, sqrt: exp(3M) 

logarithm, power,/ exp, log, loglO, pow, sqrt: exponential, .... exp(3M) 

/log 10, pow, sqrt: exponential, logarithm, power, square root/ .... exp(3M) 

errpt: process a report of logged errors errpt(IM) 

getlogin: get login name getlogin(3C) 

logname: get login name lognameO) 

cuserid: get character login name of the user cuserid(3S) 

logname: return login name of user logname(3X) 

passwd: change login password passwd(l) 

login: sign on login(l) 

setting up an environment at login time profile: profile(M) 

logname: get login name lognameO ) 

user logname: return login name of ..... logname(3X) 
a641, 164a: convert between long integer and base-64 ASCII/ ... a641(3C) 

independent/ sputl , sgetl: access long integer data in a machine .... sputl(3X) 

between 3-byte integers and long integers /ltol3: convert 13tol(3C) 

setjmp, longjmp: non-local goto setjmp(3C) 

for an object library lorder: find ordering relation .... lorderO) 

nice: run a command at low priority nice(1) 

to an LP line printer lp, cancel: send/cancel requests .. lp(1) 

send/cancel requests to an LP line printer lp, cancel: ....... lp(1) 

enable, disable; enable/disable LP printers enable(l) 

/lpshut, lpmove: start/ stop the LP request scheduler and move/ .... lpsched(IM) 

accept, reject: allow/ prevent LP requests accept(IM) 

lpadmin: configure the LP spooling system lpadmin(IM) 

lpstat: print LP status information lpstat(l) 

spooling system. lpadmin: configure the LP lpadmin(IM) 

lpd: line printer daemon lpd(ic) 

request/ lpsched, lpshut, lpmove: start/ stop the LP lpsched(lM) 

lpr: line printer spooler IprCl) 

start/ stop the LP request/ lpsched, lpshut, lpmove: lpsched(IM) 
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LP request scheduler/ lpsched, lpshut, Ipmove: start/ stop the .... lpsched(1M', 

information lpstat: print LP status lpstat(l) 

jrand48,/ drand48, erand48, lrand48, nrand48, mrand48, drand48(3C) 

Is: list contents of directories .. ls(1) 

update lsearch: linear search and lsearch(3C) 

pointer lseek: move read/write file lseek(2) 

integers and long/ 13 tol , ltol3: convert between 3-byte 13 tol( 3 C) 

m4: macro processor m4(1) 

fscv : convert files between M68000 and VAX-11/780/ fscv(IM) 

your processor/ pdpll, u3b, vax, m68k: provide truth value about ... machid(l) 

/access long integer data in a machine independent fashion. sputl(3X) 

documents mm: the MM macro package for formatting mm(5) 

mosd : the OSDD adapter macro package for formatting/ mosd(5) 

permuted index mptx: the macro package for formatting a .... mptx(5) 

viewgraphs and/ mv : a troff macro package for typesetting mv(3) 

m4: macro processor rn4(1) 

documents formatted with the MM macros /checkmm: print/check mm(1) 

this manual man: macros for formatting entries in .. man(5) 

rmail; send mail to users or read mail mail, mail(l) 

or read mail mail, rmail: send mail to users ... raail(l) 

mail, rmail: send mail to users or read mail mail(l) 

malloc, free, realloc, calloc: main memory allocator malloc(3C) 

groups of programs make: maintain, update, and regenerate ,. make(l) 

ar : archive and library maintainer for portable archives .. ar(1) 

intro: introduction to system maintenance commands and/ intro(IM) 

intro: introduction to system maintenance procedures intro(8) 

mkdir: make a directory mkdir(l) 

ordinary file mknod : make a directory, or a special or . mknod(2) 

mktemp: make a unique filename ............ mktemp(3C) 

regenerate groups of programs make: maintain, update, and ....... make( 1 ) 

banner: make posters banner(l) 

makekey: generate encryption key .. makekey(l) 
main memory allocator malloc, free, realloc, calloc: .... malloc(3C) 

entries in this manual man: macros for formatting man(5) 

onyx: Onyx 6810 special system service .. onyx(2) 

service onyx: Onyx 6810 special system .... onyx(2) 

one spare: replace a bad sector with a spare . spare(8) 

spare: replace a bad sector with a spare one spare(8) 

sparelist: list the spared sectors associated with a slice ... sparelist(8) 

onyx: Onyx 6810 special system service onyx(2) 

spared sectors associated with a slice sparelist: list the sparelist(8) 

replace a bad sector with a spare one spare: spare(8) 

a spare one spare: replace a bad sector with .. spare(8) 

slice sparelist: list the spared sectors associated with a .. sparelist(8) 

sectors associated with a slice sparelist: list the spared sparelist(8) 

onyx: Onyx 6810 special system service onyx(2) 

adduser: add a user to the system adduser(IM) 

onyx: Onyx 6810 special system service onyx (2) 

checkcw: prepare constant-width text for troff cw, cw(1) 

plock: lock process, text, or data in memory plock(?) 

tgetstr, tgoto , tputs: terminal/ tgetent, tgetnum, tgetflag, termcap(3) 

terminal/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: .. termcap(3) 
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tgoto, tputs: terminal/ tgetent, tgetnum, tgetflag, tgetstr, termcap(3) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal/ .. termcap(3) 

tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal/ tgetent, .. termcap(3) 

ttt, cubic: tic-tac-toe ttt(6) 

stime: set time stime(2) 

time: get time time(2) 

time: time a command time( 1 ) 

data and system activity timex: time a command; report process .... timex(l) 

systems for optimal access time, dcopy: copy file dcopy(IM) 

time: get time time(?) 

profil: execution time profile profil(2) 

up an environment at login time profile: setting profiled) 

time: time a command time( 1 ) 

asctime, tzset: convert date and time to string /gmtime, ctime(3C) 

clock: report CPU time used clock(3C) 

process times times: get process and child times(2) 

update access and modification times of a file touch: touch(l) 

get process and child process times times: times(2) 

set file access and modification times utime: utime(2) 

process data and system/ timex: time a command; report timex(l) 

tmpfile: create a temporary file .. tmpfile(3S) 
for a temporary file tmpnam, tempnam: create a name .... tmpnam(3S) 

/tolower, __toupper, ^tolower , toascii: translate characters conv(3C) 

‘popen, pclose: initiate pipe to/from a process popen(3S) 

toupper, tolower, _toupper , ^tolower, toascii: translate/ ..... conv(3C) 

toascii: translate/ toupper, "tolower, __toupper, ^tolower, ...... conv(3C) 

tsort: topological sort tsort(l) 

acctmerg: merge or add total accounting files acctmerg(IM) 

modification times of a file touch: update access and touch(l) 

translate/ toupper, tolower, _to upper , _tolower , toascii: conv(3C) 

^tolower, toascii: translate/ toupper, tolower, _toupper, conv(3C) 

/tgetflag, tgetstr, tgoto, tputs: terminal independent/ termcap(3) 

tr : translate characters tr(1) 

ptrace: process trace ptrace(2) 

trace: event-tracing driver trace(7) 

tr : translate characters tr(1) 

__toupper, ^tolower , toascii: translate characters /tolower, .... conv(3C) 

ftw: walk a file tree ftw(3C) 

twalk: manage binary search trees tsearch, tdelete, tsearch(3C) 

tan, asin, acos, atan, atan2: trigonometric functions /cos, trig(3M) 

tbl : format tables for nroff or troff tbl(1) 

prepare constant-width text for troff cw, checkcw: cw( 1 ) 

typesetting viewgraphs and/ mv : a troff macro package for mv(5) 

mathematical text for nroff or troff /neqn, checkeq: format ...... eqn(1) 

troff: typeset text troff d ) 

values true, false: provide truth trued ) 

pdpll, u3b, vax, m68k: provide truth value about your processor/ . machid(l) 

true, false: provide truth values true(1 ) 

binary search trees tsearch, tdelete, twalk: manage ... tsearch(3C) 

tsort: topological sort tsort(l) 

ttt, cubic: tic-tac-toe ttt(6) 

interface tty: controlling terminal tty(7) 
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tty: get the terminal’s name ...... tty(1) 

greek: graphics for the extended TTY-37 type-box greek(5) 

terminal ttyname, isatty: find name of a ... ttyname(3C) 

utmp file of the current user ttyslot: find the slot in the ..... ttyslot(3C) 

/runacct, shutacct, startup, turnacct: shell procedures for/ ... acctsh(IM) 

trees tsearch, tdelete , twalk: manage binary search ....... tsearch(3C) 

file; determine file type filed ) 

getty: set terminal type, modes, speed, and line/ gettyOM) 

truth value about your processor type /u3b, vax, m68k: provide machid(l) 

graphics for the extended TTY-37 type-box greek: greek(5) 

types: primitive system data types types(5) 

types types: primitive system data types(5) 

and slides mmt, mvt: typeset documents, viewgraphs, .... mmt(1) 

troff: typeset text troff (1 ) 

mv : a troff macro package for typesetting viewgraphs and/ mv(5) 

/localtime, gmtime, asctime, tzset: convert date and time to/ .. ctime(3C) 

value about vour/ pdpll, u3b, vax, ra68k: provide truth ..... machid(l) 

getpw: get name from UID getpw(3C) 

ulimit: get and set user limits ... ulimit(2) 
mask uraask: set and get file creation .. umask(2) 

mask umask: set file-creation mode umask(l) 

file system, mount, umount: mount and dismount mount(IM) 

umount: unmount a file system umount(2) 

operating system uname: get name of current uname(2) 

System uname: print name of current UNIX . unameCl) 
input stream ungetc: push character back into .. ungetc(3S) 

seed 48 , lcong48: generate uniformly distributed/ /srand48, .. drand48(3C) 

file uniq: report repeated lines in a .. uniq(1) 

mktemp: make a unique filename mktemp(3C) 

units: conversion program units(l) 

config: configure UNIX SYSTEM V config .68 C 1M) 

cu: call another UNIX SYSTEM V system cu(IC) 

unlink system calls, link, unlink: exercise link and link(IM) 

unlink: remove directory entry .... unlink(2) 

unlink: exercise link and unlink system calls, link, link(IM) 

umount: unmount a file system umount(2) 

files pack, peat, unpack: compress and expand pack(1) 

lsearch: linear search and update lsearch(3C) 

times of a file touch: update access and modification .... touch(l) 

programs make: maintain, update, and regenerate groups of .. make(1) 

sync: update super-block sync(2) 

sync: update the super block sync(1) 

du: summarize disk usage du(1) 

logname; return login name of user logname(3X) 

su: become superuser or another user su(1) 

write: write to another user write(l) 

setuid, setgid; set user and group IDs setuid(p) 

id: print user and group IDs and names id(i) 

get character login name of the user cuserid: cuserid(3S) 

and/ /getgid, getegid : get real user, effective user, real group, . getuid(2) 

environ: user environment environ(5) 

ulimit: get and set user limits ulimit(2) 
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/getegid : get real user, effective user, real group, and effective/ getuid(2) 

adduser: add a user to the system * adduser(IM) 

in the utmp file of the current user ttyslot: find the slot ttyslot(3C) 

wall: write to all users wall(IM) 

editor (variant of ex for casual users) edit: text edit(1) 

mail, mail: send mail to users or read mail mail(l) 

statistics ustat: get file system ustat(2) 

modification times utime: set file access and utime(2) 

utmp, wtmp: utmp and wtmp entry formats utmp(M) 

endutent, utmpname: access utmp file entry /setutent, getut(3C) 

ttyslot: find the slot in the utmp file of the current user ttyslot(3C) 

formats utmp, wtmp: utmp and wtmp entry ... utmp(H) 

/pututline, setutent, endutent, utmpname: access utmp file entry .. getut(3C) 

clean-up. uuclean: uucp spool directory uuclean(IM) 

uusub: monitor uucp network uusubdM) 

uuclean: uucp spool directory clean-up uuclean(IM) 

control uustat: uucp status inquiry and job uustat(IC) 

copy uucp, uulog, uuname: unix to unix . uucp(IC) 
uucp, uulog, uuname: unix to unix copy .. uucp(IC) 

uucp, uulog, uuname: unix to unix copy uucp(tC) 

System- to-UN IX System file/ uuto , uupick: public UNIX uuto(IC) 

job control uustat: uucp status inquiry and ... uustat(IC) 

uusub: monitor uucp network uusub(IM) 

System-to-UNIX System file copy uuto, uupick: public UNIX uuto(IC) 

execution uux : unix to unix command uux(IC) 

abs: return integer absolute value abs(3C) 

/u3b, vax, m68k: provide truth value about your processor type ... machid(t) 

getenv: return value for environment name getenv(3C) 

ceiling, remainder, absolute value functions /fabs: floor, ..... floor(3M) 

true, false: provide truth values true(1 ) 

edit: text editor (variant of ex for casual users) .. edit(1) 

about your processor/ pdpli, u3b, vax, m68k: provide truth value .... machid(l) 

/files between M68000 and VAX-11/780 processors. fscv(IM) 

vc: version control vcO) 

get option letter from argument vector getopt: getopt(3C) 

assert: verify program assertion assert(3X) 

vpr: Versatec printer spooler vprO) 

vc: version control vcO) 

display editor based on ex vi: screen oriented (visual) v i ( 1 ) 

rant, mvt: typeset documents, viewgraphs, and slides mmt(1 ) 

macro package for typesetting viewgraphs and slides /a troff .... mv(5) 

ex vi: screen oriented (visual) display editor based on .. vi(1) 

systems with label checking. volcopy, labelit: copy file volcopy(IM) 

systems with label checking. volcopy, labelit: copy file volcopy . 1m. old 

file system: format of system volume fs(4) 

vpr: Versatec printer spooler vpr(1) 

process wait: await completion of wait(1) 

terminate wait: wait for child process to stop or . wait(2) 

stop or terminate wait: wait for child process to ... wait(2) 

ftw: walk a file tree ftw(3C) 

wall: write to all users wall(IM) 

wc: word count wc(1) 
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signal signal: specify what to do upon receipt of a signal(2) 

signal signal: specify what to do upon receipt of a signal. 2. old 

crashes crash: what to do when the system crash. m68(8) 

whodo: who is doing what whodo(IM) 

who: who is on the system who(1) 

who: who is on the system who(1) 

whodo: who is doing what whodo(IM) 

cd : change working directory cd(l) 

chdir: change working directory chdir(2) 

getcwd: get pathname of current working directory getcwd(3C) 

pwd : working directory name pwd(i) 

write: write on a file write(2) 

putpwent: write password file entry putpwent(3C) 

wall: write to all users. wall(IM) 

write: write to another user write(l) 

write: write on a file write(?) 

write: write to another user write(l) 

open: open for reading or writing open(2) 

utmp, wtmp: utmp and wtmp entry formats utmp(4) 

formats utmp, wtmp: utmp and wtmp entry utmp(4) 

accounting records, fwtmp, wtmpfix: manipulate connect fwtrop(IM) 

hunt-'the-wumpus wump: the game of wump(6) 

and execute command xargs: construct argument list(s) . xargs(l) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

jO, jl. jn, yO, yl, yn: Bessel functions bessel(3M) 

compiler ^compiler yacc: yet another yacc(l) 

jO, jl. jn, yO, yl, yn: Bessel functions bessel(3M) 
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INTRO ( 1 M) 


NAME 

intro t- introduction to system maintenance commands and 
application programs 

DESCRIPTION 

This section describes, in alphabetical order, commands that 
are used chiefly for system maintenance and administration 
purposes. The commands in this section should be used along 
with those listed in Section 1 of the UNIX System User 1 s 
Manual . References to other manual entries not of the form 
name ( 1 M ) , name ( 7 ) or n am e ( 8 ) refer to entries of that 
manual . 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section 
accept options and other arguments according to the follow- 
ing syntax : 

n ame [ opUon ( s) ] [ cmdarg ( s> ) ] 

where: 

name The name of an executable file. 

option tr noar gletter ( s) or, 

rr* argletter O optarg 
where <> is optional white space. 

noarg letter A single letter representing an option without 
an argument. 

argletter A single letter representing an option require 
i ng an argument. 

opt ar g Argument (character string) satisfying preced- 

ing argletter . 

cmdar g Path name (or other command argument) no t 

beginning with or, by itself indicating the 
stand ar d input . 

SEE ALSO 

getopt(l), g e to pt ( 3 C ) . 

UNIX Sys tem User 1 s Manual . 

UNIX System Adm ini str ator 1 s Guide . 

DIAGNOSTICS 

Upon termination, each command returns two bytes of status, 
one supplied bv the system and giving the cause for termina- 
tion, and (in the case of ''normal’’ termination) one sup- 
plied by the program (see wa i t ( 2 ) and ex i t ( 2 ) ) . The former 
byte is 0 for normal termination; the latter is customarily 
0 for successful execution and non^-zero to indicate troubles 
such as erroneous parameters, bad or inaccessible data, or 
other inability to cope with the task at hand. It is called 
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(6/28/83) 


INTPO(IM) 


variously ''exit code 1 1 , ''exit status’’, or ''return 
code" , and is described only where special conventions are 
involved. 


BUGS 

Regretfully, many commands do not adhere to the aforemen-r- 
tioned syntax. 
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NAME 

accept, reject - allow /prevent LP requests 

SYNOPSIS 

/usr/lib/accept destinations 

/usr / 1 ib/r e j ec t [-r[reason] ] destinations 

DESCRIPTION 

Accept allows JLp( 1 ) to accept requests for the named dest i- 
nations . A destination can be either a printer or a class 
of printers. Use lpstat ( 1 ) to find the status of destina- 
tions . 

Re j ec t prevents 1_£( 1 ) from accepting requests for the named 
destinations . A destination can be either a printer or a 
class of printers., Use lpstat ( 1 ) to find the status of des- 
tinations . The following option is useful with reject . 

-r [ r e a son ] Associates a reason with preventing _lp from 

accepting requests. This r e a son applies to 
all printers mentioned up to the next -r 
option. Reason is reported by 1 p when users 
direct requests to the named destinations and 
by 1 pst a t ( 1 ) . If the -r option is not present 
or the -r option is given without a r eason , 
then a default reason will be used. 

FILES 

/ usr / spool / 1 p/* 

SEE ALSO 

enabled ) , lp(1), IpadminCiM), Ipsched(IM), lpstat(l). 
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NAME 

acctdisk, acctdusg, accton, acctwtmp - overview of account- 
ing and miscellaneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 

/usr/ lib/acct/ acctdusg [-u file] [-p file] 

/ usr / 1 i b / ac c t/ ac c ton [file] 

/ usr / 1 i b / acc t/ acc twtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (con- 
sisting of both C programs and shell procedures) that can be 
used to build accounting systems. Acc t sh ( 1 M ) describes the 
set of shell procedures built on top of the C programs. 

Connect time accounting is handled by various programs that 
write records into /usr/adm/utmp , as described in utmp ( 4 ) . 
The programs described in acctcon(IM) convert this file into 
session and charging records, which are then summarized by 
acc tmerg ( 1 M ) . 

Process accounting is performed by the 
kernel. Upon termination of a process, one record per pro- 
cess is written to a file (normally /usr/adm/pacct ) . The 
programs in acctprc (IM) summarize this data for charging 
purposes; ac c tern s ( 1 M ) is used to summarize command usage. 
Current process data may be examined using ac c tcom ( 1 ) . 

Process accounting and connect time accounting (or any 
accounting records in the format described in ac c t ( 4 ) ) can 
be merged and summarized into total accounting records by 
acc tmerg (see tacct format in acet ( 4 ) ) . Pr tacc t (see 
acctsh (IM)) is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and 
number of disk blocks and converts them to total accounting 
records that can be merged with other accounting records. 

Acctdusg reads its standard input (usually from find / 
-print) and computes disk resource consumption (including 
indirect blocks) by login. If -u is given, records consist- 
ing of those file names for which acc tdusg charges no one 
are placed in file (a potential source for finding users 
trying to avoid disk charges). If -p is given, file is the 
name of the password file. This option is not needed if the 
password file is /etc/passwd. 

Accton alone turns process accounting off. If file is 
given, it must be the name of an existing file, to which the 
kernel appends process accounting records (see acc t ( 2 ) and 
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acct ( 4 ) ) . 

Ac ctwtmp writes a u t m p ( 4 ) record to its standard output. 
The record contains the current time and a string of charac- 
ters that describe the reason . A record type of ACCOUNTING 
is assigned (see u t m p ( 4 ) ) . Reason must be a string of 11 or 
less characters, numbers, $, or spaces. For example, the 
following is a suggestion for use in shutdown procedures: 

acctwtmp file save" >> /etc/wtmp" 


FILES 

/etc/passwd 

/usr/lib/acct 

/usr/adm/pacct 
/etc /wtmp 


used for login name to user ID conversions 
holds all accounting commands listed in 
sub-class 1M of this manual 
current process accounting file 
login/logoff history file 


SEE ALSO 

acctcms(IM), acctcom(l), acctcon(IM), acc tmer g ( 1 M) , 
acctprc(IM), acctsh(IM), fwtmp(IM), runacct(IM), acct(2), 
acc t ( 4 ) , utmp( 4 ) . 
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ACCTCOK ( 1 M) 


NAME 

acctconl, acctcon? -- connect-rtime accounting 

SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/usr /lib/acct/ acctcon2 
DESCRIPTION 

Acctconl converts a sequence of login/logoff records read 
from its standard input to a sequence of records, one per 
login session. Its input should normally be redirected from 
/etc/wtmp. Its output is ASCII, giving device, user ID, 
login name, prime connect time (seconds), non^prime connect 
time (seconds), session starting time (numeric), and start? 
ing date and time. The options are: 

Print input only, showing line name, login name, 
and time (in both numeric and date/time formats). 
Acctconl maintains a list of lines on which users 
are logged in. When it reaches the end of its 
input, it emits a session record for each line 
that still appears to be active. It normally 
assumes that its input is a current file, so that 
it uses the current time as the ending time for 
each session still in progress. The ,-t flag 
causes it to use, instead, the last time found in 
its input, thus assuring reasonable and repeatable 
numbers for non-current files. 

File is created to contain a summary of line usage 
showing line name, number of minutes used, percen- 
tage of total elapsed time used, number of ses- 
sions charged, number of logins, and number of 
logoffs. This file helps track line usage, iden^ 
tifv bad lines, and find software and hardware 
oddities. Hang-up, termination of log in ( 1 ) and 
termination of the login shell generate logoff 
records, so that the number of logoffs is often 
three to four times the number of sessions. See 
ini t ( 1 M) and utmp ( 4 ) . 

File is filled with an overall record for the 
accounting period, giving starting time, ending 
time, number of reboots, and number of date 
changes . 

Acc tcon2 expects as input a sequence of login session 
records and converts them into total accounting records (see 
tacct format in ac c t ( 4 ) ) . 

EXAMPLES 

These commands are typically used as shown below. The file 
otmp is created only for the use of acctprc ( 1M) commands: 




rrl file 


o file 
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acctconl <?t <-1 lineus e -c-o reboots <wtmp I sort +1n + 2 >ctmp 
acctcon? <ctmp | acctmerg >ctacct 

FILES 

/etc/wtmp 

SEE ALSO 

acct(IM), acctcms( 1M) , acctcom(l), acc tmer g ( 1 M ) t 

acctprc(IM) , acctsh(IM), fwtmp(IM), runacctC 1M) , ■ acct(2) , 
a c c t ( 4 ) , utmp( 4 ) , 


BUGS 

The line usage report is confused by date changes. Use 
wtmpfix (see fwtmp( 1 M) ) to correct this situation. 
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NAME 

acctcms - command summary from per-process accounting 
records 

SYNOPSIS 

/usr/lib/acct/acctcms [options] files 
DESCRIPTION 

Acctcms reads one or more files , normally in the form 
described in ac c t ( 4 ) . It adds all records for processes 
that executed identically-named commands, sorts them, and 
writes them to the standard output, normally using an inter- 
nal summary format. The options are:. 

-a Print output in ASCII rather than in the internal sum- 
mary format. The output includes command name, number 
of times executed, total kcore-minutes , total CPU 
minutes, total real minutes, mean size (in K) , mean CPU 
minutes per invocation, and ''hog factor’’, as in 
acc tcom ( 1 ) . Output is normally sorted by total kcore- 
minutes . 


- c 

Sort by total 
minutes . 

CPU time, 

rather 

than 

total kcore- 

- j 

Combine all 
* * *ot her ’ ’ . 

command s 

invoked 

only 

once under 

-n 

Sort by number 

of command 

invocations . 


- s 

Any file names 

en c oun ter ed 

hereafter are 

already in 


internal summary format. 





A typical sequence for performing daily command accounting 
and for maintaining a running total is: 

acctcms file ... >today 

cp total pr evioustotal 

acctcms -s today pr ev iousto tal >total 

acctcms -a -s today 

SEE ALSO 

acct(IM), acctcom(l), acctcon(IM), acc tmerg ( 1M) , 

acctprc(IM), acctsh(IM), fwtmp(IM), runacct(IM), acct(P), 
acct ( 4 ) , utmp( 4 ) . 


1 


Printed 6 1985 



ACCTMERG ( 1 M ) 


ACCTMERG ( 1 H) 


NAME 

acctmerg - merge or add total accounting files 
SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] . . . 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional 
files in the tacct format (see acc t ( 4 ) ) , or in an ASCII ver- 
sion. It merges these inputs by adding records whose keys 
(normally user ID and name) are identical, and expects the 
inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

- p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-V Produce output in verbose ASCII format, with more pre- 
cise notation for floating point numbers. 

The following sequence is useful for making repairs to any 
file kept in this format: 

acctmerg -v <file1 >file2 

Perform edit on file? , then enter: 

acctmerg -a <file2 >file1 


SEE ALSO 

acct(IM), acctcms(IM), acctcom(l), acctcon(IM), acctprc(IM), 
acctsh(IM), fwtmp(IM), runacct(lM), acct(2), acct(4), 
utm p ( 4 ) . 
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NAME 

acctprcl, acctprc2 - process accounting 

SYNOPSIS 

/usr / 1 ib / acc t/ ac c t pr c 1 [ctmp] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

Acctprcl reads input in the form described bv acct ( 4 ) , adds 
login names correspond ing to user IDs, then writes for each 
process an ASCII line giving user ID, login name, prime CPU 
time (tics), non-prime CPU time (tics), and mean memory size 
(in 64-bvte units). If ctmp is given, it is expected to 
contain a list of login sessions, in the form described in 
ac c tc on ( 1 M ) , sorted by user ID and login name. If this file 
is not supplied, it obtains login names from the password 
file. The information in ctmp helps it distinguish among 
different login names that share the same user ID. 

Acc t pr c2 reads records in the form written by acctprcl , sum- 
marizes them by user ID and name, then writes the sorted 
summaries to the standard output as total accounting 
records. 

These commands are typically used as shown below: 
acctprcl ctmp </usr/adm/pacc t | acctprc2 >ptacct 

FILES 

/etc/ pa sswd 

SEE ALSO 

acct(IM) , acctcms(IM), acctcom(l), acctcon(IM), 

acctmerg( 1M) , acctsh(IM), fwtmp(IM), runacct(IM), acct(2), 
acct ( 4 ) , utrap( 4 ) . 

BUGS 

Although it is possible to distinguish among login names 
that share user IDs for commands run normally, it is diffi- 
cult to do this for those commands run from cron ( 1M) , for 
example. More precise conversion can be done by faking 
login sessions on the console via the acc twtmp program in 
acct ( 1 M) . 
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NAME 

chargefee , ckpacct, d o d i s k , lastlogin, monacct, n u 1 1 a d m , 
prctmp, prdailv, prtacct, remove, runacct, shutacct, 
startup, turnacct - shell procedures for accounting 

SYNOPSIS 

/usr / lib/acc t/ char gefee login-name number 
/usr/ lib/acct/ ckpacct [blocks] 

/usr/lib/acct/dodisk 
/usr/lib/acct/lastlogin 
/usr / lib/acc t/monacc t number 
/usr/ lib/acct/nulladm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [ ramdd ] 

/usr/ lib/acct/pr tacct file [ "heading” ] 

/usr/lib/acct/remove 

/usr/ lib/acct/runacct [mmdd] [mmdd state] 

/usr / lib/acct/ shutacct [ "reason" ] 

/usr / lib/acc t/ st art up 

/usr/lib/acct/turnacct on i off i switch 
DESCRIPTION 

Char g efee can be invoked to charge a n umber of units to 
login - name . A record is written to /usr/adm/ fee , to be 
merged with other accounting records during the night. 

Ckpacct should be initiated via cron ( 1 M ) . It periodically 
checks the size of /usr / adm/ pace t . If the size exceeds 
blocks , 1000 by default, turnacct is invoked with argument 

switch . If the number of free disk blocks in the /usr file 
system falls below 500, ckpacct automatically turns off the 
collection of process accounting records via the off argu- 
ment to turnacct . When at least this number of blocks is 
restored, accounting is reactivated. This feature is sensi- 
tive to the frequency at which ckpacct is executed, usually 
by cron . 

Pod i sk should be invoked by cron to perform the disk 
accounting functions. 
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L a s 1 1 o g i n is invoked by ru nacct to update 
/ usr / adm/ ac c t/ sum/ log ini og , which shows the last date on 
which each person logged in. 

Mon ac c t should be invoked once each month or each accounting 
period. Number indicates which month or period it is. If 
number is not given, it defaults to the current month 
(01-12). This default is useful if monacc t is to executed 
via cron ( 1 M ) on the first day of each month. Monacc t 
creates summary files in /usr /adm/acct/ fi seal and restarts 
summary files in /usr / adm/ acc t/ sum . 

Nu 1 1 adm creates file with mode 664 and insures owner and 
group are adm. It is called by various accounting shell 
procedures . 

Pr c tmp can be used to print the session record file (nor- 
mally /usr / adm/ acct/ni te/ctmp created by acc tcon 1 (see 
acc tcon ( 1 M ) ) . 

Pr d ai 1 v is invoked by runacct to format a report of the pre- 
vious day’s accounting data. The report resides in 
/usr/adm/aoct/ sum/rprt mmdd where mmd d is the month and day 
of the re port. The current daily accounting reports may be 
printed bv typing prd aily . Previous days’ accounting 
reports can be printed by using the mmdd option and specify- 
ing the exact report date desired. Previous daily reports 
are cleaned up and therefore inaccessible after each invoca- 
tion of monacc t . 

Pr tacc t can be used to format and print any total accounting 
( tacct ) file. 

Remove is invoked to remove the previous day’s accounting 
files. It is located in /lib and called by startup when the 
system is brought up each day. This should be invoked only 
by /usr / lib/acc t/star tup and never by a user or an adminis- 
trator. 

Runacct performs the accumulation of connect, process, fee, 
and disk accounting on a daily basis. It also creates sum- 
maries of command usage. For more information, see 
r un ac c t ( 1 M ) . 

Shut ac c t should be invoked during a system shutdown (usually 
in /etc/shutdown) to turn process accounting off and append 
a ''reason’’ record to /etc/wtmp. 

Startup should be called by /etc/rc to turn the accounting 
on whenever the system is brought up. 

Tur nacc t is an interface to acc ton (see acc t ( 1 M ) ) to turn 
process accounting on or off. The switch argument turns 
accounting off, moves the current /usr/adm/pacct to the next 
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free name in /usr/adm/pacct incr (where inc r is a number 
starting with 1 and incrementing by one for each additional 
pacct file), then turns accounting back on again. This pro- 
cedure is called by c kp a c c t and thus can be taken care of by 
the cron and used to keep pacct to a reasonable size. 


FILES 

/usr/ ad m/fee 
/usr / ad rn /pacct 
/ usr / ad m / pacct* 

/etc/ wtm p 

/usr/adm/acct/nite 

/usr/lib/acct 

/usr/adm/acct/sum 


accumulator for fees 

current file for per-process accounting 
used if pacct gets large and during 
execution of daily accounting procedure 
login/logoff summary 
working directory 

holds all accounting commands listed in 
sub-class 1M of this manual 
summary directory, should be saved 


SEE ALSO 

acct(IM), acctcms(IM), acctcom(l), acctcon(IM), 
acc tmerg ( 1 M) , acctprc(IM), fwtmp(IM), runacct(IM), acct(2) , 
acc t( 4 ) , utrap( 4 ) . 
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NAME 

adduser - add a user to the system 

SYNOPSIS 

/ etc / ad d user 

DESCRIPTION 

Adduser performs all the necessary tasks to add a user 
account to the system such as setting the login name, 
account’s uid and gid , password, login shell and the 
account’s home directory, automatically. Adduser prompts 
you for each parameter to be entered; however, adduser 
requires that you be either looged into the ’’root” account 
or become a super-user. 


FILES 

/etc/adduser /etc/passwd / e t c / pr o f i 1 e* 
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NAME 

bcopv - interactive block copy 

SYNOPSIS 

/ e tc / bcopy 

DESCRIPTION 

Bcopy copies from and to files starting at arbitrary block 
(512-byte) boundaries. 

The following questions are asked; 

to; name the file or device to be copied to. 

offset; provide the starting "to" block number. 

from; name the file or device to be copied from. 

offset; provide the starting ''from’ 1 block number. 

count: reply with the number of blocks to be copied. 

After count is exhausted, the from question is repeated 
(providing the ability to concatenate blocks at the 
to+of f se t+coun t location). If from is answered with a car- 
riage return, everything starts over. 

Two consecutive carriage returns terminates bcopy . 

SEE ALSO 

c pio ( 1 ) , dd ( 1 ) . 
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NAME 

brc , bcheckrc , rc , powerfail - system initialization shell 
scripts 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 

/ etc / rc 

/ etc/power fail 
DESCRIPTION 

Except for power fail , these shell procedures are executed 
via entries in /etc/inittab by in i t ( 1 M ) when the system is 
changed out of SINGLE U SER mode. Powerfail is executed 
whenever a system power failure is detected. 

The brc procedure clears the mounted file system table, 
/etc/mnttab (see mnt tab ( 4 ) ) . 

The bcheckrc procedure performs all the necessary con- 
sistency checks to prepare the system to change into multi- 
user mode. It will prompt to set the system date and to 
check the file systems with f sc k ( 1 M ) . 

The rjc procedure starts all system daemons before the termi- 
nal lines are enabled for multi-user mode. In addition, 
file systems are mounted and accounting, error logging, and 
system activity logging are activated in this procedure. 

The power fail procedure is invoked when the system detects a 
power failure condition. It also logs the fact that a power 
failure occurred. 

These shell procedures, in particular, rc , may be used for 
several run-level states. The who(1) command may be used to 
get the run-level information. 

SEE ALSO 

init(IM), shutdown( 1 M) , who ( 1 ) , inittab(M). 
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NAME 

checkall - faster file system checking procedure 

SYNOPSIS 

/etc/checkall 

DESCRIPTION 

The checkall procedure is a prototype and must be modified 
to suit local conditions. The following will serve as a 
example : 

// check the root file system by itself 
fsck / d e v / d sk/ cO dO s 1 

// dual fsck of drives 0 and 1 

dfsck / d e v / d sk/ cO dO s 3 - / d e v / d sk/ cO d 1 s 1 

In the above example (where / d ev/ d sk/ cOd 1 s 1 is 3^K blocks 
and /dev/dsk/c0d0s3 is 25K blocks), a previous sequential 
fsck took 3. minutes. The checkall procedure also takes 3 
minutes. 

Dfsck is a program that permits an operator to interact with 
two fsck ( 1 M) programs at once. To aid in this, dfsck will 
print the file system name for each message to the operator. 
When answering a question from dfsck , the operator must pre- 
fix the response with a 1 or a 2 (indicating that the answer 
refers to the first or second file system group). 

Due to the file system load balancing required for dual 
checking, the dfsck command should always be executed 
through the checkal l shell procedure. 

In a practical sense, the file systems are divided up as 
fol lows : 

dfsck f i 1 e__sys t em s_on__dr i v e_0 - f i 1 e__sys t ems_on_d r i ve_1 
dfsck file systems on drive 2 - file systems on__drive__3 


WARNINGS 

1. Do not use dfsck to check the root file system. 

2. On a check that requires a scratch file (the -t option), 
be careful not to use the same temporary file for the two 
groups (this is sure to scramble the file systems). 

3. ? he f! f sc k procedure is useful only if the system is set 
up for multiple physical I/O buffers. 

SEE ALSO 

f sck( 1 M) . 

Setting up the UNIX System in the UNIX System 

Administrator’s Guide. 
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NAME 

chroot - change root directory for a command 

SYNOPSIS 

/bin/chroot newroot command 

DESCP I PTION 

The given command is executed relative to the new root . The 
meaning of any initial slashes (/) in path names is changed 
for a command and any of its children to newroot . Further- 
more, the initial working directory is newroot . 

Notice that: 

chroot newroot command >x 

will create the file x relative to the original root, not 
the new one. 

This command is restricted to the super-user. 

The new root path name is always relative to the current 
root: even if a chroot is currently in effect, the newroot 

argument is relative to the current root of the running pro- 
cess. 

SEE ALSO 

chd i r ( 2 ) . 


BUGS 

One should exercise extreme caution when referencing special 
files in the new root file system. 
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NAME 

clri - clear i-node 
SYNOPSIS 

/bin/clri file-system i-number ... 

DESCRIPTION 

Clri writes zeros .on the 64 bytes occupied by the i-node 
numbered i- number . Fi 1 e - svstem must be a special file name 
referring to a device containing a file system. After clri 
is executed, any blocks in the affected file will show up as 
missing' 1 in an f sc k ( 1 M ) of the f i 1 e - system . This command 
should only be used in emergencies and extreme care should 
be ex ere i sed . 

Read and write permission is required on the specified 
f i 1 e - system device. The i-node becomes allocatable. 

The primary purpose of this routine is to remove a file 
which for some reason appears in no directory. If it is 
used to zap an i-node which does appear in a directory, care 
should be taken to track down the entry and remove it. Oth- 
erwise, when the i-node is reallocated to some new file, the 
old entry will still point to that file. At that point 
removing the old entry will destroy the new file. The new 
entry will again point to an unallocated i-node, so the 
whole cycle is likely to be repeated again and again. 

SEE ALSO 

fsck(IM), fsdb(IM), ncheck(IM), fs(4). 

BUGS 

If the file is open, clri is likely to be ineffective. 
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NAME 

config.68 - configure 
SYNOPSIS 

/ etc / conf i g . 68 [ -t ] [ -v file ] [ -1 file ] [ -c file ] [ 

~m file ] dfile 

DESCRIPTION 

Config .68 is a program that takes a description of 
and generates two files. One file provides information 
regarding the interface between the hardware and device 
handlers. The other file is a C program defining the confi- 
guration tables for the various devices on the system. 

The -v option specifies the name of the exception vector 
file; m68kvec.s is the default name. 

The ~1 option specifies the name of the hardware interface 
file; low.s is the default name. 

The -c option specifies the name of the configuration table 
file; conf.c is the default name. 

The -m option specifies the name of the file that contains 
all the information regarding supported devices; /etc/master 
is the default name. This file is supplied with 
and should not be modified unless the user fully under- 
stands its construction. 

The -t option requests a short table of major device numbers 
for character and block type devices. This can facilitate 
the creation of special files. 

The user must supply dfile; it must contain device informa- 
tion for the user’s system. This file is divided into three 
parts. The first part contains physical device specifica- 
tions. The second part contains system-dependent informa- 
tion. The third part contains microprocessor-specific 
information. The first two parts are required, the third 
part is optional. Any line with an asterisk (*) in column 1 
is a comment. 

First Part of d f j l e 

Each line contains four or five fields, delimited by blanks 
and/or tabs in the following format; 

devname vector address bus number 

where devname is the name of the device (as it appears in 
the /etc/master device table), vector is the interrupt vec- 
tor location (hexadecimal), add ress is the device address 
(hexadecimal), bus is the bus request level (1 through 7), 
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and num ber is the number (decimal) of devices associated 
with the corresponding controller; numbe r is optional, and 
if omitted, a default value which is the maximum value for 
that controller is used, 

There are certain drivers which may be provided with the 
system that are actually pseudo-device drivers, that is, 
there is no real hardware associated with the driver. 
Drivers of this type are identified on their respective 
manual entries. When these devices are specified in the 
description file, the interrupt vector , device a ddress , and 
bus request level must all be zero. 

Second Part of d f i 1 e 

The second part contains three different types of lines. 
Note that all specifications of this part are required, 
although their order is arbitrary. 

1 . Roo t / pi pe / d urn p device specification 

Three lines of three fields each: 

root d evname m inor [ , m i n o r . . . ] 

pi pe d evname minor [ ,m ino r . . . ] 

dump d evname minor [ , m inor ... ] 

where minor is the minor device number (in octal). For 

certain Motorola Inc. disk controllers, e.g., the 
Universal Disk, it is possible, and often desirable, to 
have a single UNIX System capable of executing on any 
device on the controller. For such devices, minor can 
be repeated (separated by commas). The first reference 
to minor specifies the root (pipe, dump) to be used for 
disk 0, the second min or for disk 1, etc. The same 
number of minor references must be present for root, 
pipe, dump, and swap. 

2 . Swap device s pec i fi catio n 

One line that contains five fields as follows: 

swap d e y n am e minor s wplo nswa p [ .minor 

s wplo ns wap . . . ] 

where swpl o is the lowest disk block (decimal) in the 
swap area and n s wa p is the number of disk blocks 
(decimal)' in the swap area. Similar to the root, pipe, 
and dump specifications above, the minor, swplo, and 
nswap references can be repeated for certain Motorola 
Inc . controllers. 

3. Par amete r specification 
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Several lines of two fields each as follows (number is 
decimal) : 


buffers 

number 

inodes 

number 

files 

number 

mounts 

number 

cor emap 

number 

swapm ap 

number 

calls 

number 

pr oc s 

number 

max proc 

number 

texts 

number 

cl i st s 

n urn b er 

ha shbuf 

number 

physbuf 

number 

power 

0 or 1 

mesg 

0 or 1 

sema 

0 or 1 

shm em 

0 or 1 


Third Part of d f i l e 

The third part contains lines identified by a keyword. The 
format of each line differs for each keyword. The ordering 
of the third part is significant. 

1 . Microprocessor specification 
One line of two fields: 

mpu number 

where number is 68000, 68010, or 68020. The default mpu 
number is 68000. 

2 . Non - un i qu e d river spec ifications 
Several lines of two fields: 

force identifier 

where id enti f ier is the name of a unique identifier 
defined within a driver, located in the kernel I/O 
library file. This forces the correct linking of non- 
table driven drivers, such as those for the clock, con- 
sole, and mmu . 

3 • Memory probe spec i fi cations 

Several lines of three fields: 
probe address value 
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wh ere addre ss is the hexadecimal number specifying a 
memory-mapped I/O location, which must be reset for to 
execute properly. The intent is to provide a means by 
which non-standard (or unsupported) devices can be set 
to a harmless state. Value is a hexadecimal number 
(0X00-0XFF) to be written in address , or -J_, indicating 
that the address is to be "read only 1 ’ . 

4 . Alien handler entry specifications 
Several lines of three fields: 

alien <vector address> <alien address> 

where vector address is the hexadecimal address of the 
normal exception vector for the alien entry point, and 
alien a ddres s is the hexadecimal entry point for the 
non-UNIX handler. If no UNIX handler is associated with 
the vec tor address , then alien addres s is entered into 
the vector. Otherwise, code is produced in 1 o w . s so 
that the ..alien handler is entered only when the excep- 
tion occurs in the processor’s supervisor state. 

5 . Multiple handler specifications 
Several lines of four or five fields: 

dup flag <vector address> handler [argument] 

where fla g is a bit mask. The bits are interpreted as: 

1 - if handler returns 0, go to the normal interrupt 

return point ("intret"). 

2 - if handler returns 0, go to the normal trap 

return point ( " al 1 tr a ps " ) . 

4 - if handler returns 0, go to the quick return 

point ("return” ). 

10 - ar g urn en t is to be passed to handler . 

Vector addre ss is the hexadecimal address of the normal 
exception vector for the firmware entry point. Hand 1 er 
is the name of an exception handling routine, with the 
optional argument passed to it. The intent is to pro- 
vide a means of specifying multiple handlers for a sin- 
gle exception. These handlers are called in the order 
given in d f i 1 e ; then, the normal handler is called. If 
bits 1, 2 or 4 of flag are set and the handler returns 
zero, then the remainder of the handlers are not called. 
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6 . Memory configurati on specifications 
Several lines of four of five fields: 
ram flag low high [size] 

where flag is an octal bit mask, which is interpreted as 
follows : 

1 - memory has no parity check and, therfore, 

need not be initialized after power up. 

2 - a single memory block may exist, ranging from 

low through high -1 . 

4 - multiple memory blocks may be located in the 
range and are of size bytes. 

Low and hi^gh are hexadecimal memory addresses, and size 
is a hexadecimal number. The intent is to provide 
information to about noncontiguous memory. Low speci- 
fies the low memory address where memory may be 
located, and which may extend through h i g h - 1 . If the 
range consists of multiple boards, which may or may not 
be present, they are of size bytes. 

For flag 2 ranges, UNIX writes sequential memory loca- 
tions, starting at low, until a memory fault occurs. 
For flag 4 ranges, UNIX performs a test for each si ze - 
sized subrange. If memory need not be initialized, 
only the first byte of the range (flag 2) or subrange 
(flag 4) is tested to determine the presence of the 
memory. 

It is essential that r am lines be ordered in ascending 
low addresses. If two low s are equal (more than one 
size memory block may be located within a range), they 
must be ordered in ascending size s. 

If no ram specifier is present, the default is: 

ram 2 0 F00000 


EXAMPLE 

The actual system configuration table would be specified as 
follows (comments may be inserted by preceding the comment 
with an asterisk (*)): 

* System Devices 


root 

disk 

10 



swap 

disk 

17 

1 

3292 

pipe 

disk 

10 
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dump disk 17 
* Tunable Parameters 


buffers 

50 

calls 

50 

inodes 

90 

files 

90 

mounts 

8 

pr oc s 

50 

texts 

40 

cl i st s 

1R0 

s ab uf s 

0 

max pr oc 

15 

coremap 

100 

s wa pm a p 

75 

h a s h b u f 

64 

p h v s b u f 

4 

power 

0 

rnesg 

1 

sem a 

1 

s h m e m 

1 


* See <sys/io.h> 


FILES 

/etc/master default input master device table 
m68kv ec . s 

default output exception vector file for m68k 

low.s 

default output hardware interface file for m68k 
con f . c 

default output configuration table file 


SEE ALSO 

sysdef(IM), master(4). 

''Setting up 11 in the Adm in i str a tor * s Guid e. 

DIAGNOSTICS 

Diagnostics are routed to the standard output and are self 
explanatory. 
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NAME 

crash - examine system images 

SYNOPSIS 

/etc/crash [ system ] [ namelist ] 

DESCRIPTION 

Cr ash is an interactive utility for examining an operating 
system core image. It has facilities for interpreting and 
formatting the various control structures in the system and 

certain miscellaneous functions that are useful when perus- 

ing a d urn p . 

The arguments to crash are the file name where the system 
image can be found and a n am el i st file to be used for symbol 
values. 

The default values are /dev/mem and /unix; hence, crash with 
no arguments can be used to examine an active system. If a 
system image file is given, it is assumed to be a system 
core dump and the default process is set to be that of the 

process running at the time of the crash. This is deter- 

mined by a value stored in a fixed location by the dump 
mechanism . 

COMMANDS 

Input to crash is typically of the form: 

command [ options ] C structures to be printed ] 

When allowed, options modifies the format of the printout. 
If no specific structure elements are specified, all valid 
entries are used. As an example, proc - 12 15 3 would print 
process table slots 12,. 15 and 3 in a long format, while 

proc would print the entire process table in standard for- 
mat. 

In general, those commands that perform I/O with addresses 
assume hexadecimal on 32-bit machines and octal on 16-bit 
machines. 

The current list of commands includes: 

user [ list of process table entries ] 

Aliases: uarea, u^area, u. 

Print the user structure of the named process as deter- 
mined by the information contained in the process table 
entry. If no entry number is given, the information of 
the last executing process is printed. Swapped 
processes produce an error message. 

trao® [ — r ] C list of process table entries ] 
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Aliases: t . 

Generate a kernel stack trace of the current process. 
If the -r option is used, the trace begins at the saved 
stack frame pointer in kfp. Otherwise the trace starts 
at the bottom of the stack and attempts to find valid 
stack frames deeper in the stack. If no entry number 
is given, the information on the last executing process 
is printed. 

kfp [ stack frame pointer ] 

Aliases: fp. 

Print the program’s idea of the start of the current 
stack frame (set initially from a fixed location in the 
dump) if no argument is given, or set the frame pointer 
to the supplied value. 

stack [ list of process table entries ] 

Aliases: stk, s, kernel, k. 

Format a dump of the kernel stack of a process. The 
addresses shown are virtual system data addresses 
rather than true physical locations. If no entry 
number is given, the information on the last executing 
process is printed. 

proc L — [ r ] ] [ list of process table entries ] 

Aliases: ps, p. 

Format the process table. The -r option causes only 
runnable processes to be printed. The - alone gen- 
erates a longer listing. 

inode [-] [ list of inode table entries ] 

Aliases: ino, i. 

Format the inode table. The - option also prints the 
inode data block addresses. 

file [ list of file table entries ] 

Aliases: files, f . 

Format the file table. 

mount [ list of mount table entries ] 

Aliases: mnt , m . 

Format the mount table. 

text [ list of text table entries ] 

Aliases : txt , x . 

Format the text table. 

tty [type] [-] [ list of tty entries ] 

Aliases: term, acia. 

Print the tty structures. The type argument determines 
which structure is used (such as acia; the last type is 
remembered). The - option prints the stt y ( 1 ) 


2 


Printed ‘6 1985 



CRASH C 1 M) 


CRASH ( 1 M ) 


parameters for the given line. 

Stat Print certain statistics found in the dump. These 
include the panic string (if a panic occurred), time of 
crash, system name, and the registers saved in low 
memory by the dump mechanism. 

var Aliases: tunables, tunable, tune, v. 

Print the tunable system parameters. 

buf [ list of buffer headers 3 
Aliases: hdr, bufhdr. 

Format the system buffer headers. 

buffer [ format ] [ list of buffers ] 

Alias: b . 

Print the data in a system buffer according to form a t . 
If format is omitted, the previous format is used. 
Valid formats include decimal, octal, hex, character, 
byte, directory, inode, and write. The last creates a 
file in the current directory (see ’’FILE?") containing 
the buffer data. 

callout 

Aliases: calls, call, c, timeout, time, tout. 

Print all entries in the callout table. 

map [ list of map names ] 

Format the named system map structures. 

nm [ list of symbols ] 

Print symbol value and type as found in the namelist 
file. 

ts [ list of text addresses ] 

Find the closest text symbols to the given addresses. 

ds [ list of data addresses ] 

Find the closest data symbols to the given addresses. 

od [ symbol name or address ] [ count ] [ format ] 

Aliases: dump, r d . 

Dump coun t data values starting at the symbol value or 
address given according to format . Allowable formats 
are octal, longoct, decimal, longdec, character, hex, 
or byte. 

! Escape to shell . 

q Exit from crash . 

? Print synopsis of commands. 
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ALIASES 

There are built in aliases for many of the formats as well 
as those listed for the commands. Some of them are: 


byte 

b . 

character 

char , c 

decimal 

dec, e . 

directory 

direct , 

hexadecimal 

he x ad ec 

inod e 

ino , i 

1 ong d ec 

Id , D. 

longoc t 

lo , 0 . 

octal 

oct, o . 

write 

w . 


FILES 

/usr/inelude/sys/* .h 

/dev/ mem 
/ un i x 
b u f . // 


header files for table and structure 
info 

default system image file 
default namelist file 

files created containing buffer data 


SEE ALSO 

mount(IM), nm(1), ps(1), sh(1), stty(1), crash(8). 


BUGS 

Most flags are abbreviated and have little meaning to the 
uninitiated user. A source listing of the system header 
files at hand would be most useful while using crash. 


Stack tracing of the current process on a running system 
doesn’t work. 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times accord- 
ing to the instructions in the file /usr/lib/crontab . 
Because cron never exits, it should be executed only once. 
This is best done by running cron from the initialization 
process through the file /etc/rc (see in i t ( 1 M ) ) . 

The file crontab consists of lines of six fields each. The 
fields are separated by spaces or tabs. The first five are 
integer patterns that specify in order: 
minute (0-59), 
hour (0-23), 

day of the month (1-31), 
month of the year (1-12), 

and day of the week (0-6, with 0=Sunday). 

Each of these patterns may contain: 

a number in the (respective) range indicated above; 
two numbers separated by a minus (indicating an 
inclusive range); 

a list of numbers separated by commas (meaning all of 
these numbers); or 

an asterisk (meaning all legal values). 

The sixth field is a string that is executed by the shell at 
the specified time(s). A % in this field is translated into 
a new-line character. Only the first line (up to a % or the 
end of line) of the command field is executed by the shell. 
The other lines are made available to the command as stan- 
dard input. 

Cron examines crontab once a minute to see if it has 
changed; if it has, cron reads it. Thus it takes only a 
minute for entries to become effective. 

FILES 

/usr/lib/crontab 

/usr/adra/cronlog 

SEE ALSO 

in i t ( 1 M) , sh ( 1 ) . 

DIAGNOSTICS 

A history of all actions by cron are recorded in 
/usr/adm/cronlog. 

BUGS 

Cron reads crontab only when it has changed, but it reads 
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the in-core version of that table once a minute. A more 
efficient algorithm could be used. The overhead in running 
cron is about one percent of the CPU, exclusive of any com- 
mands executed by cron . 
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NAME 

dcopy - copy file systems for optimal access time 

SYNOPSIS 

/etc /dcopy [-sX] [-an] C-d] [-v] [-ffsizesisize] input fs 

o ut put f s 

DESCRIPTION 

Deo py copies file system in pu t f s to out put f s . Input f s is 
the existing file system; output fs is an appropriately sized 
file system, to hold the reorganized result. For best 
results i n pu t f s should be the raw device and out put f s should 
be the block device. Dcopy should be run on unmounted file 
systems (in the case of the root file system, copy to a new 
pack). With no arguments, dcopy copies files from in put f s 
compressing directories by removing vacant entries, and 
spacing consecutive blocks in a file by the optimal rota- 
tional gap. The possible options are: 


-sX 


-an 


-d 


supply device information for creating an optimal 
organization of blocks in a file. The forms of X 
are the same as the -s option of f sc k ( 1 M) . 

place the files not accessed in n days after the 
free blocks of the destination file system 
(default for n is 7). If no n is specified then 
no movement occurs. 

leave order of directory entries as is (default is 
to move sub-directories to the beginning of direc- 
tories) . 

reports how many files were processed , and how big 
the source and destination freelists are. 


-f fsize [ ; i si ze ] 

specify the output f s file system and inode list 
sizes (in blocks). If not given, the values from 
the input f s are used. 

Dcopy catches interrupts and quits and reports on its pro- 
gress. To terminate dcopy , send a quit signal, and dcopy 
will no longer catch interrupts or quits. Dcopy also 
attempts to modify its commandline arguments so its progress 
can be monitored with ps ( 1 ) . 

SEE ALSO 

fsck(IM), mkfs(IM), ps(1). 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [names] 

DESCRIPTION 

Devnm identifies the special file associated with the 
mounted file system where the argument name resides (as a 
special case, both the block device name and the swap device 
name is printed for the argument name / if swapping is done 
on the same disk section as the root file system). Argument 
names must be full path names. 

This command is most commonly used by /etc/rc (see 
bcheckr c( 1M) ) to construct a mount table entry for the root 
device. 

EXAMPLE 

The command ; 

/etc/devnm / usr 
prod uc e s 

d sk/ c0d0s2 /usr 

if /usr is mounted on /dev/dsk/c0d0s2 . 


FILES 

/dev/ d sk* 

/etc/mnttab 

SEE ALSO 

bcheckrc(IM), setmnt(IM). 
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NAME 

(if - report number of free disk blocks 
SYNOPSIS 

df [ -t ] [ — f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes 
available for on-line file systems by examining the counts 
kept in the super-blocks; f i 1 e - systems may be specified 
either by device name (e.g., / dev/ d sk/ c0d0s2 ) or by mounted 
directory name (e.g., /usr). If the f i 1 e - systems argument 
is unspecified, the free space on all of the mounted file 
systems is printed. 

The -t flag causes the total allocated block figures to be 
reported as well . 

If the -f flag is given, only an actual count of the blocks 
in the free list is made (free i-nodes are not reported). 
With this option, df will report on raw devices. 


FILES 

/dev/dsk* 

/etc/mnttab 

SEE ALSO 

f s ( 4 ) , m n 1 1 ab ( 4 ) . 
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NAME 

errdead - extract error records from dump 
SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error 
record that contains information pertinent to the error is 
generated. If the error-logging daemon errdemon C 1 M ) is not 
active or if the system crashes before the record can be 
placed in the error file, the error information is held by 
the system in a local buffer. Er r d ead examines a system 
dump (or memory), extracts such error records, and passes 
them to er r pt ( 1 M) for analysis. 

The d urn pf i 1 e specifies the file (or memory) that is to be 
examined. The system namelist is specified by namel i st ; if 
not given, /unix is used. 

FILES 

/unix 

/usr/bin/errpt 
/usr/tmp/errXXXXXX 

DIAGNOSTICS 

Diagnostics may come from either er r d ead or er r pt . In 
either case, they are self-explanatory. 

SEE ALSO 

er r d emon ( 1 M ) , errpt(IM). 


system namelist 
analysis program 
temporary file 
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NAME 

errfiemon - er ror-logg ing daemon 

SYNOPSIS 

/usr / lib/errd emon [ file ] 

DESCRIPTION 

The error logging daemon er r d emon collects error records 
from the operating system by reading the special file 
/dev/error and places them in file . If file is not speci- 
fied when the daemon is activated, /usr / adm/ err f i 1 e is used. 
Note that file is created if it does not exist; otherwise, 
error records are appended to it, so that no previous error 
data is lost. No analysis of the error records is done by 
er r d emo n ; that responsibility is left to errpt ( 1 M ) . The 
error-logging daemon is terminated by sending it a software 
kill signal (see signal ( ? ) ) . Only the super-user may start 
the daemon, and only one daemon may be active at any time. 

FILES 

/dev/error source of error records 

/ usr / adm/ err f i 1 e repository for error records 

DIAGNOSTICS 

The diagnostics produced by er r d emon are intended to be 
self-explanatory. 

SEE ALSO 

errpt(IM), errstop(IM), kill(1), err(7). 
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NAME 

errpt - process a report of logged errors 

SYNOPSIS 

errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechan- 
ism ( errdemon C 1 M ) ) and generates a report of that data. The 
default report is a summary of all errors posted in the 
files named. Options apply to all files and are described 
below. If no files are specified, errpt attempts to use 
/usr / adro/ er r f i 1 e as file . 

A summary report notes the options that may limit its com- 
pleteness, records the time stamped on the earliest and 
latest errors encountered, and gives the total number of 
errors of one or more types. Each device summary contains 
the total number of unrecovered errors, recovered errors, 
errors unabled to be logged, I/O operations on the device, 
and miscellaneous activities that occurred on the device. 
The number of times that errpt has difficulty reading in put 
data is included as read errors. 


Any detailed report contains, in addition to specific error 
information, all instances of the error logging process 
being started and stopped, and any time changes (via 
d a te ( 1 ) ) that took place during the interval being pro- 
cessed. A summary of each error type included in the report 
is appended to a detailed report. 


A report may be limited to certain records in the following 
ways: 

-s d a t e Ignore all records posted earlier than dat e, 

where date has the form mmddhhmmyy , con- 
sistent in meaning with the date d ) command. 

-e ^ a Ignore all records posted later than date , 

whose form is as described above. 


-a 


Produce a detailed report that includes all 
error types. 


-d d e v 1 i st A detailed report is limited to data about 

devices given in d ev 1 i st , where d ev 1 i st can 
be one of two forms: a list of device iden- 
tifiers separated from one another by a 
comma, or a list of device identifiers 
enclosed in double quotes and separated from 
one another by a comma and/or more spaces. 
Errpt is familiar with the common form of 
identifiers. For the EXORmacs, the device 
for which errors are logged is jjd(7). For 
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3 B 2 0 S , the devices are D F C , 1 0 P , and MI. 

For Digital Equipment Corporation machines, 
the (block) devices for which errors are 
logged are RP03, RP04, RP05, RP06, FP07, 
RS03, RS04 , TS11, TU10, TU16, TU78, PK05, 

RK06, RK07, RM 05 , PM 80 , and RF 11. Addi- 
tional identifiers are int and mem which 
include detailed reports of stray-interrupt 
and memory-parity type errors respectively. 

-p r» Limit the size of a detailed report to n 

pages . 

-f In a detailed report, limit the reporting of 

block device errors to unrecovereri errors. 


FILES 

/usr/ adm/ errfile default error file 

SEE ALSO 

errdemon(IH) , errfile(4). 
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NAME 

errstop - terminate the error-logging daemon 
SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon ( 1 M ) is terminated by using 
errstop . This is accomplished by executing j>s(1) to deter- 
mine the daemon’s identity and then sending it a software 
kill signal (see si gnal ( 2 ) ) ; /unix is used as the system 
namelist if none is specified. Only the superuser may use 
errstop . 


FILES 

/unix default system namelist 

DIAGNOSTICS 

The diagnostics produced by errstop are 

SEE ALSO 

errdemon(IM), p s ( 1 ) , k i 1 1 ( 2 ) . 


self-explanatory. 
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NAME 

ff - list file names and statistics for a file system 
SYNOPSIS 

/bin/ff [options] special 
DESCRIPTION 

F f reads the i-list and directories of the special file, 
assuming it to be a file system, saving i-node data for 
files which match the selection criteria. Output consists 
of the path name for each saved i-node, plus any other file 
information requested using the print options below. Output 
fields are positional. The output is produced in i-node 
order; fields are separated by tabs. The default line pro- 
duced bv fT i s : 

path -name i-number 

With all options enabled, output fields would be: 
path-name i-number size uid 

The argument n in the option descriptions that follow is 
used as a decimal integer (optionally signed) , where +n_ 
means more than n, -n means less than n, and n means exactly 


n . 

A day 

is defined as a 24 hour period 

• 


-I 


Do not print the i-node 
pathname. 

number after 

each 

-1 


Generate a supplementary 
names for multiply linked 

list of all 
files. 

path 

«-p 

prefix 

The specified prefix will 
generated path name. The 

be added to 

default is . . 

each 

— s 


Print the file size, in 

path name . 

bytes, a f ter 

each 

-u 


Print the owner's login name after each 
name . 

path 

-a 

n 

Select if the i-node has 
days. 

been accessed 

in n 


n 

Select if the i-node has 
days. 

been modified 

in n 

— c 

n 

Select if the i-node has 
days. 

been changed 

in n 

-n 

file 

Select if the i-node has been modified 
recently than the argument file. 

more 


1 - 


Printed 6 1985 



FF ( 1 M ) 


(1/28/85) 


FF ( 1 M ) 


-i i - nod e - 1 i s t Generate names for only those i-nodes speci- 
fied in i- nod e - list . 

EXAMPLES 

To generate a list of the names of all files on a specified 
file system: 

ff -I /dev/dsk/cOdOs 1 

To produce an index of files and i-numbers which are on a 
file system and have been modified in the last 24 hours: 

ff -m -1 /dev/ d sk/ c0d0s2 > / log / i neb ac kup/ usr / t ue sd ay 

To obtain the path names for i-nodes 451 and 76 on a speci- 
fied f i 1 e system : 

ff -i 451 , 76 /dev/d sk/ cOdOs 1 

SEE ALSO 

finc(IM), find(1), frec(IM), ncheck(IM). 

BUGS 

Only a single path name out of any possible ones will be 
generated for a multiply linked i-node, unless the -1 option 
is specified. When -1 is specified, no selection criteria 
apply to the names generated. All possible names for every 
linked file on the file system will be included in the out- 
put . 

On very large file systems, memory may run out before f f 
does. 
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NAME 

filesave, tapesave - daily/weekly UNIX file system backup 

SYNOPSIS 

/etc /filesave 
/etc/tape save 

DESCRIPTION 

These shell scripts are provided as models. They are 
designed to provide a simple, interactive operator environ- 
ment for file backup. Filesave is for daily disk-to-tape 
backup and tapesa ve is for weekly d i sk-to-ta pe . 


FILES 

/etc /filesave 
/ e tc / ta pe sa v e 

SEE ALSO 

c pio ( 1 ) . 
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NAME 

fine - fast incremental backup 

SYNOPSIS 

fine [selection-criteria] file-system raw-tape 
DESCRIPTION 

Fine selectively copies the input f i 1 e - system to the output 
raw - tape . The cautious will want to mount the input file - 
system read-only to insure an accurate backup, although 
acceptable results can be obtained in read-write mode. The 
tape must be previously labelled by 1 ab el i t (see 
volcopy (IM)) . The selection is controlled by the 
selection - criteria , accepting only those inodes/files for 
whom the conditions are true. 

It is recommended that production of a fine tape be preceded 
by the _ff command, and the output of _ff be saved as an index 
of the tape’s contents. Files on a fine tape may be 
recovered with the f r ec command. 

The argument n in the selection - criteria which follow is 
used as a decimal integer (optionally signed), where +n 
means more than n, -n means less than n, and n means exactly 
n. A day is defined as a 24 hours. 

-a n True if the file has been accessed in n 

days. 

n True if the file has been modified in n 

days. 

-c_n True if the i-node has been changed in n 

days. 

-n £1 1 e True for any file which has been modified 

more recently than the argument file . 

EXAMPLES 

To write a tape consisting of all files from file-system 
/usr modified in the last 48 hours: 

fine -m -2 /dev/rd sk/c0d0s2 /dev/rmt__rwd 

SEE ALSO 

cpio(1), f f ( 1 M ) , frec(IM), volcopv(IM). 
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NAME 

free - recover files from a backup tape 

SYNOPSIS 

/bin/frec [~p path] [-f reqfile] raw-tape i-number :name ... 
DESCFIPTION 

Free recovers files from the specified raw - tape backup tape 
written by vol copy ( 1 M) or fine ( 1 M) , given their i- number s . 
The data for each recovery request will be written into the 
file given by name . 

The »p option allows you to specify a default prefixing path 
different from your current working directory. This will be 
prefixed to any names that are not fully qualified, i.e. 
that do not begin with / or ./. If any directories are 
missing in the paths of recovery names they will be created. 


-p path 

Specifies a prefixing path 

to be 

used to 


fully qualify any names 
with / or ./ . 

that do 

not start 

-f reqfile 

Specifies a file which 

contains 

r ecov er y 

requests. The format is 
one per line. 

i-number 

:newname , 


EXAMPLES 

To recover a file, i-number 1216 when backed-up, into a file 
named junk in your current working directory: 

free /dev/rmt__rwd 1216:junk 

To recover files with i-numbers 14156, 1232, and 3141 into 

files /usr/sre/emd/a , /usr / sr c/ cmd/b and /usr/ joe/a .c : 

free -p /usr/src/cmd /dev/rmtO 14156:a 1232:b 

3141 :/usr/ joe/a.c 


SEE ALSO 

cpio(l), ff(1M), finc(IM), volcopy(IM). 

BUGS 

While paving a path (i.e. creating the intermediate direc- 
tories contained in a pathname) fr ec can only recover inode 
fields for those directories contained on the tape and 
requested for recovery. 
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NAME 

fsba - file system block analyzer 

SYNOPSIS 

fsba f i 1 e system . . . 

DESCRIPTION 

Fsba determines the number of extra sectors (1 sector has 
512 bytes) needed when the file system logical block size is 
increased from 512 bytes per block to 1024 bytes/block. 
File system should be specified by device name (e.g. f 
/dev/ dk 1 1 ) . 

Fsba determines how many sectors are currently allocated for 
the 512 bytes/block file system, and how many sectors are 
required for the 1024 bytes/block converted file system. 
Fsba also prints out the number of allocated and free 
inodes for each file system . 

If the number of free sectors for the 1024 bytes/block file 
system is negative, the file system is too large to convert 
to 1024 bytes/block. 

SEE ALSO 

f s ( 4 ) . 
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NAME 

fsck, dfsck - file system consistency check and interactive 
repair 

SYNOPSIS 

/etc/fsck [ -e-y ] [-n] [^sX] [-SX] [-t file] L-q] [-D] [*<? f ] 

[ file-systems] 

/etc/dfsck [ optionsl ] filsysl ... - [ options2 ] filsys? 


DESCRIPTION 

Fsck 

Fsck audits and interactively repairs inconsistent condi- 
tions for UNIX System files. If the file system is con- 
sistent then the number of files, number of blocks used, and 
number of blocks free are reported. If the file system is 
inconsistent the operator is prompted for concurrence before 
each correction is attempted. It should be noted that most 
corrective actions will result in some loss of data. The 
amount and severity of data lost may be determined from the 
diagnostic output. The default action for each consistency 
correction is to wait for the operator to respond yes or no. 

If the operator does not have write permission fsck will 
default to a — n action. 

Fsck has more consistency checks than its predecessors 
^ chec k , f c h e c k , and ic heck combined. 

The following options are interpreted by fsck . 

<cy Assume a yes response to all questions asked by f sck . 

-n Assume a no response to all questions asked by fsck ; 

do not open the file system for writing. 

-sX Ignore the actual free list and (unconditionally) 
reconstruct a new one by rewriting the super-block of 
the file system. The file system should be unmounted 
while this is done; if this is not possible, care 
should be taken that the system is quiescent and that 
it is rebooted immediately afterwards. This precau- 
tion is necessary so that the old, bad, in-core copy 
of the superblock will not continue to be used, or 
written on the file system. 

The -sX option allows for creating an optimal free- 
list organization. The following forms of X are sup- 
ported for the following devices: 

-sBloc ks-per-cy 1 ind er :Bloc ks-to-ski p (for anything else) 

If X is not given, the values used when the file sys- 
tem was created are used. If these values were not 
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specified, then the value 400 *7 is used. 

«rS X Conditionally reconstruct the free list. This option 

is like r?sX above except that the free list is rebuilt 
only if there were no discrepancies discovered in the 
file system. Using will force a no response to all 
questions asked by f sc k . This option is useful for 
forcing free list reorganization on uncontaminated 
file system s . 

f SQ k cannot obtain enough memory to keep its 
tables, it uses a scratch file. If the ,-t option is 
specified, the file named in the next argument is used 
as the scratch file, if needed. Without the T-t flag, 
f s c k will prompt the operator for the name of the 
scratch file. The file chosen should not be on the 
file system being checked, and if it is not a special 
file or did not already exist, it is removed when f sc k 
compl ete s . 

r?q Quiet f s c k . Do not print size-check messages in Phase 

1. Unreferenced fifos will silently be removed. If 
f s c k requires it, counts in the superblock will be 
automatically fixed and the free list salvaged. 

ttD Directories are checked for bad blocks. Useful after 
system crashes. 

rrf Fast check. Check block and sizes (Phase 1) and check 
the free list (Phase 5). The free list will be recon-r 

structed (Phase 6) if it is necessary. 

If no file - systems are specified, f sc k will read a list of 

default file systems from the file / etc/ chec kl i St . 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free 
list. 

2. Blocks claimed by an inode or the free list out- 
side the range of the file system. 

3. Incorrect link counts. 

4 . Size checks: 

Incorrect number of blocks. 

Directory size not 16-^byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in 

the file system. 
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9. Bad free block list format. 

10. Total free block and/or free inode count 
incorrect . 

Orphaned files and directories (allocated but unreferenced) 
are, with the operator’s concurrence, reconnected by placing 
them in the lost+found directory, if the files are nonempty. 
The user will be notified if the file or directory is empty 
or not. If it is empty, f s ck will silently remove them. 
Fs c k will force the reconnection of nonempty directories. 
The name assigned is the inode number. The only restriction 
is that the directory , lost+found must preexist in the root 
of the file system being checked and must have empty slots 
in which entries can be made. This is accomplished by mak-r 
ing lost+found, copying a number of files to the directory, 
and then removing them (before f s c k is executed). 

Df sck 

Df sc k allows two file system checks on two different drives 
simultaneously. opt ions 1 and opt ions 2 are used to pass 
options to f sck for the two sets of file systems. A <=■ is 
the separator between the file system groups. 

The d f s c k program permits an operator to interact with two 
f sck ( 1 M) programs at once. To aid in this, d f sck will print 
the file system name for each message to the operator. When 
answering a question from df sck , the operator must prefix 
the response with a 1 or a 2 (indicating that the answer 
refers to the first or second file system group). 

Do not use d f sck to check the root file system. 

FILES 

/etc/checklist 
/etc/checkall 


SEE ALSO 

checkal 1 ( 1 M) , clri(IM), ncheck(IM), chec kl i st ( 4 ) , fs(4), 
cr a sh ( 8 ) . 

Setting up the UNIX System in the UNIX System 

Admin istrator 1 s Guide . 

BUGS 

Inode numbers for . and .. in each directory should be 
checked for validity. 

DIAGNOSTICS 

The diagnostics produced by f sck are intended to be self- 
explanatory. 


contains default list of file systems 
to check. 

optimizing d f s c k shell file. 
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NAME 

fscv - convert files between M68000 and VAX-11/780 proces- 
sors 

SYNOPSIS 

/etc/fscv — v ispecial [ ospecial ] 

/etc/fscv -m ispecial [ ospecial ] 

DESCRIPTION 

Fscv converts file systems between M68000 and VAX-11/780 
formats. The super block, free list, and inodes are con- 
verted to the format of the output file. Fscv may be exe- 
cuted on M68000 and VAX processors. The mandatory flag 
specifies the format of the converted file system: 

-v Convert file system from M68000 to VAX format. 

-m Convert file system from VAX to M68000 format. 

Ispeci al is the name of a special file containing a file 
system to be converted (e.g., /dev/rdkIO). The optional 
ospecial is the name of the special file to receive the 
results of the conversion. If ospecial is specified, the 
entire contents of i special are copied to ospec ial before 
the conversion is performed. If ospecial is not specified, 
an in-place conversion of. ispecial is performed. The fol- 
lowing items should be noted before executing f sc v : 

1. A file system consistency check ( f sc k ( 1 M ) ) should be 
performed on ispecia l immediately prior to executing 
fscv . 

2. Neither ispecial nor the optional ospec ial should con- 
tain a mounted file system during execution of fscv . 
Modification to either the input or the output file 
system while fscv is executing will probably corrupt 
the converted file system. 

3. A backup of i spec ial (see vol copy ( 1 M) ) is highly 
recommended if an in-place conversion is to be per- 
formed. System crashes, I/O errors, etc., during exe- 
cution of fscv may destroy the file system contained 
in is P ec ial . Also, if the optional ospecial is speci- 
fied, any data contained in that special file is over 
written . 

4. If the optional ospecial is specified, this special 
file must be large enough to contain the entire con- 
tents of ispecial . See the appropriate special files 
in sec tion 4 . 

EXAMPLES 

Copy and convert a file system from M68000 to VAX format: 
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/etc/fscv -v /dev/rdkOO /dev/rdkIO 
Perform an in-place conversion from VAX to M68000 format: 
/etc/fscv -m /dev/rdkIO 

BUGS 

The boot block is not modified during conversion; the 
resulting file system is not bootable. No data contained in 
the files of the file system are modified. 

SEE ALSO 

fsck( 1 M ) , volcopy( 1 M ) . 
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NAME 

fsdb, fsdblb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ rr ] 

/etc/fsdblb special [ ? ] 

DESCRIPTION 

Fsd b can be used to patch up a damaged file system after a 
crash. It has conversions to translate block and i-numbers 
into their corresponding disk addresses. Also included are 
mnemonic offsets to access different parts of an inode. 
These greatly simplify the process of correcting control 
block entries or descending the file system tree. 

Fsd b contains several error checking routines to verify 
inode and block addresses. These can be disabled if neces- 
sary by invoking f sd b with the optional - argument or by the 
use of the 0 symbol. ( Fsd b reads the i-size and f-size 
entries from the superblock of the file system as the basis 
for these checks.) 

Numbers are considered decimal by default. Octal numbers 
must be prefixed with a zero. During any assignment operas 
tion, numbers are checked for a possible truncation error 
due to a size mismatch between source and destination. 

Fsd b reads a block at a time and, therefore, works with raw 
as well as block I/O. A buffer management routine is used to 
retain commonly used blocks of data in order to reduce the 
number of read system calls. All assignment operations 
result in an immediate wr i ter* thro ug h of the corresponding 
block. 


The 


symbols recognized by fsdb are; 


absolute address 

convert from irnumber to inode address 
convert to block address 
directory slot offset 
address arithmetic 


q 

>,< 


s 11 

0 

p 

f 

B 

W 

D 

1 


quit 

save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip flop 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 
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The print facilities generate a formatted output in various 
styles. The current address is normalized to an appropriate 
boundary before printing begins. It advances with the 
printing and is left at the address of the last item 
printed. The output can be terminated at any time by typing 
the delete character. If a number follows the p symbol, 
that many entries are printed. A check is made to detect 
block boundary overflows, since logically sequential blocks 
are generally not physically sequential. If a count of zero 
is used, all entries to the end of the current block are 
printed. The print options available are; 
i print as inodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with 
the current inode. If followed by a number, that block of 
the file is printed. (Blocks are numbered from zero.) The 
desired print option letter follows the block number, if 
present, or the f symbol. This print facility works for 
small as well as large files. It checks for special devices 
and that the block pointers used to find the data are not 
zero . 

Dots, tabs and spaces may be used as function delimiters but 
are not necessary. A line with just a newline character 
increments the current address by the size of the data type 
last printed. That is, the address is set to the next byte, 
word, double word, directory entry or inode, allowing the 
user to step through a region of a file system. Information 
is printed in a format appropriate to the data type. Bytes, 
words and double words are displayed with the octal address 
followed by the value in octal and decimal. A .B or .D is 
appended to the address for byte and double word values, 
respectively. Directories are printed as a directory slot 
offset followed by the decimal i-number and the character 
representation of the entry name. Inodes are printed with 
labeled fields describing each element. 

The following mnemonics are used for inode examination and 
refer to the current working inode: 
md mode 

In link count 

uid user ID number 

gid group ID number 

8 z filesize 

a# data block numbers (0 12) 

at acc ess t im e 

mt modification time 

maj major device number 
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Kin minor device number 

Fsdbl b 

Fsd b 1 b is the same as f sd b , except f sd b 1 b is used for 

file systems with a 51 2 byte block size. 

EXAMPLES 

3 8 6 i prints irnumber 386 in an inode format. 

This now becomes the current working inode. 

1 ns 4 changes the link count for the working inode 

to 4. 

lns+1 increments the link count by 1. 

fc prints, in ASCII, block zero of the file 

associated with the working inode. 

2i.fd prints the first 32 directory entries for 

the root inode of this file system. 

d5i.fc changes the current inode to that associated 

with the 5th directory entry (numbered from 
zero) found from the above command. The 
first logical block of the file is then 
printed in ASCII. 

512B.p0o prints the superblock of this file system in 

octal . 

2i.a0b.d7=3 changes the i-number for the seventh direc- 

tory slot in the root directory to 3* This 
example also shows how several operations 
can be combined on one command line. 

d7 . nm= " name” changes the name field in the directory slot 

to the given string. Quotes are optional 
when used with nm if the first character is 
al phabetic . 

a2b.p0d prints the third block of the current inode 

as directory entries. 

SEE ALSO 

fsck(IM), dir(4), fs(4). 
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NAME 

fwtmp, wtmpfix - manipulate connect accounting records 
SYNOPSIS 

/usr / 1 ib / ac c t/ fwtmp L-ic] 

/usr/lib/acct/wtmpfix [files] 

DESCRIPTION 

Fwtmp 

Fwtmp reads from the standard input and writes to the stan- 
dard output, converting binary records of the type found in 
wtmp to formated ASCII records. The ASCII version is useful 
to enable editing, via e_d ( 1 ) , bad records or general purpose 
maintenance of the file. 

The argument -ic is used to denote that input is in ASCII 
form, and output is in binary form. 

Wtmpfix 

Wtm pf i x examines the standard input or named files in wtmp 
format, corrects the time/date stamps to make the entries 
consistent, and writes to the standard output. A «• can be 

used in place of files to indicate the standard input. If 

time/date corrections are not performed, acc tcon 1 faults 
when it encounters certain date change records. 

Each time the date is set, a pair of date change records are 
written to /etc/wtmp. The first record is the old date 
denoted by the string old time placed in the line field and 
the flag OLD__TIME placed in the type field of the <utmp.h> 
structure. The second record specifies the new date and is 

denoted by the string new time placed in the line field and 

the flag NEW__TIME placed in the type field. Wtmpfix uses 
these records to synchronize all time stamps in the file. 

In addition to correcting time/date stamps, wtmpf i x checks 
the validity of the name field to ensure that it consists 
soley of alphanumeric characters, a $, or spaces. If it 
encounters a name that is considered invalid, it changes the 
login name to INVALID and writes a diagnostic to the stan- 
dard error. In this way, wtmpf i x reduces the chance of 
acc tcon 1 failure, when processing connect accounting 
records. 


FILES 

/ etc /wtmp 

/usr/ include/utmp.h 

SEE ALSO 

acct(IM), acctcms(IM), acctcom(l), acctcon(IM), 

acctmerg ( 1 H) , acctprc(IM), acctsh(IM), runacct(IM), acct(2), 
acc t ( 4 ) , utmp( 4 ) . 
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NAME 

getty - set terminal type, modes , speed, and line discip- 
line 

SYNOPSIS 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ 

linedisc ] ] ] 

/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by i n i t ( 1 M ) . It is the 
second process in the series, ( ini t - getty - log in - shell ) that 
ultimately connects a user with the UNIX System. Initially 
gett y prints the login message field for the entry it is 
using from / e tc / ge tt yd e f s . Getty reads the user’s login 
name and invokes the 1 og in ( 1 ) command with the user's name 
as argument. While reading the name, getty attempts to 
adapt the system to the speed and type of terminal being 
used . 

Line is the name of a tty line in /dev to which getty is to 
attach itself. Getty uses this string as the name of a file 
in the /dev directory to open for reading and writing. 
Unless gett y is invoked with the -h flag, getty will force a 
hangup on the line by setting the speed to zero before set- 
ting the speed to the default or specified speed. The -t 
flag plus timeout in seconds, specifies that getty should 
exit if the open on the line succeeds and no one types any- 
thing in the specified number of seconds. The optional 
second argument, speed , is a label to a speed and tty defin- 
ition in the file / e tc / ge tt yd e f s . This definition tells 
getty what speed to initially run at, what the login message 
should look like, what the inital tty settings are, and what 
speed to try next should the user indicate that the speed is 
inappropriate. (By typing a < br e a k > character.) The default 
speed is 300 baud. The optional third argument, type , is a 
character string describing to getty what type of terminal 
is connected to the line in question. Getty understands the 
following types: 

none default 

vt6 1 DEC vt6l 

v t 1 00 DEC vtlOO 

hp45 Hewlett-Packard HP45 

C100 Concept 100 

The default terminal is nonep; i.e., any crt or normal ter- 
minal unknown to the system. Also, for terminal type to 
have any meaning, the virtual terminal handlers must be com- 
piled into the operating system. They are available, but 
not compiled in the default condition. The optional fourth 
argument, linedisc , is a character string describing which 
line discipline to use in communicating with the terminal. 
Again the hooks for line disciplines are available in the 
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operating system but there is only one presently available, 
the default line discipline, LDISCO. 

When given no optional arguments, ge tty sets the speed of 
the interface to 300 baud, specifies that raw mode is to be 
used (awaken on every character), that echo is to be 
suppressed, either parity allowed, newline characters will 
be converted to carriage return-line feed, and tab expansion 
performed on the standard output. It types the login mes- 
sage before reading the user’s name a character at a time. 
If a null character (or framing error) is received, it is 
assumed to be the result of the user pushing the ''break* ’ 
key. This will cause g e 1 1 v to attempt the next speed in the 
series. The series that ge tt y tries is determined by what 
it finds in /etc /ge ttyd ef s . 

The user’s name is terminated by a new-line or carriage- 
return character. • The latter results in the system being 
set to treat carriage returns appropriately (see ioc 1 1 ( 2 ) ) . 

The user’s name is scanned to see if it contains any lower- 
case alphabetic characters; if not, and if the name is non- 
empty, the system is told to map any future upper-case char- 
acters into the corresponding lower-case characters. 

Finally, login is called with the user’s name as an argu- 
ment. Additional arguments may be typed after the login 
name. These are passed to login , which will place them in 
the environment (see 1 og in ( 1 ) ) . 

A check option is provided. When g e t ty is invoked with the 
~c option and file , it scans the file as if it were scanning 
/etc/gettyd efs and prints out the results to the standard 
output. If there are any unrecognized modes or improperly 
constructed entries, it reports these. If the entries are 
correct, it prints out the values of the various flags. See 
ioctl (2) to interpret the values. Note that some values are 
added to the flags automatically. 

FILES 

/etc/gettydefs 
SEE ALSO 

ct(1C), init(IM), login(l), ioctl(2), ge ttyd e fs ( 4 ) , init- 
tab( 4 ) , tty (7 ) . 
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NAME 

init , telinit - process control initialization 

SYNOPSIS 

/etc/init [01 23456SsQq] 

/etc/telinit [ 01 23456sSQqabc] 

DESCRIPTION 

Init 

Init is a general process spawner , Its primary role is to 
create processes from a script stored in the file 
/etc/inittab (see in i t tab ( 4 ) ) . This file usually has init 
spawn gettv 1 s on each line that a user may log in on. It 
also controls autonomous processes required by any particu- 
lar system. 

Init considers the system to be in a r un - 1 e v el at any given 
time. A r un - level can be viewed as a software configuration 
of the system where each configuration allows only a 
selected group of processes to exist. The processes spawned 
by init for each of these run - levels is defined in the in i t- 
tab file. Init can be in one of eight run - level s , 0-6 and S 
or s. The run- level is changed by having a privileged user 
run /etc/init (which is linked to / etc / telinit ) . This user 
spawned init sends appropriate signals to the orginal init 
spawned by the operating system when the system was 
rebooted, telling it which run- level to change to. 

Init is invoked inside the UNIX System as the last step in 
'the boot procedure. The first thing init does is to look 

for /etc/inittab and see if there is an entry of the type 

in i td e f aul t (see in i t ta b ( 4 ) ) . If there is, init uses the 
run - lev el specified in that entry as the initial run- level 
to enter. If this entry is not in in i t tab or in i ttab is not 
found, ini t requests that the user enter a run- level from 
the virtual system console, /dev/syscon. If an S (s) is 
entered, init goes into the SINGLE USER level. This is the 

only run- level that doesn’t require the existence of a prop- 

erly formatted in i ttab file. If /etc/inittab doesn’t exist, 
then by default the only legal run - level that init can enter 
is the SINGLE USER level. In the SINGLE USE R level the vir- 
tual console terminal /dev/syscon is opened for reading and 
writing and the command /bin/su is invoked immediately. To 
exit from the SINGLE USER run - level one of two options can 
be elected. First, if the shell is terminated (via an end- 
of-file), init will reprompt for a new r un - level . Second, 
the * n j t or telinit command can signal init and force it to 
change the run - level of the system. 

When attempting to boot the system, failure of init to 
prompt for a new run- lev el may be due to the fact that the 
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device /dev/syscon is linked to a device other than the phy- 
sical system teletype (/dev/systty). If this occurs, i n i t 
can be forced to relink /dev/syscon by typing a delete on 
the system teletype which is co-located with the processor. 

When i n i t prompts for the new r un - 1 e v el , the operator may 
only enter one of the digits 0 through 6 or the letters S or 
s. If S is entered in i t operates as previously described in 
SINGLE USER mode with the additional result that /dev/syscon 
is linked to the user's terminal line, thus making it the 
virtual system console. A message is generated on the phy- 
sical console, /dev/systty, saying where the virtual termi- 
nal has been relocated. 

When in i t comes up initially and whenever it switches out of 
SINGL E USER state to normal run states, it sets the ioc tl ( 2 ) 
states of the virtual console, /dev/syscon, to those modes 
saved in the file / etc/ ioc tl . syscon . This file is written 
by i n i t whenever SINGLE USER mode is entered. If this file 
doesn't exist when in i t wants to read it, a warning is 
printed and default settings are assumed. 

If a 0 through 6 is entered in i t enters the corresponding 
run - level . Any other input will be rejected and the user 
will be re-prompted. If this is the first time in i t has 
entered a run - level other than SINGLE USER , in i t first scans 
in i t tab for special entries of the type boot and bootwa i t . 
These entries are performed, providing the r un - level entered 
matches that of the entry before any normal processing of 
i n i t tab takes place. In this way any special initialization 
of the operating system, such as mounting file systems, can 
take place before users are allowed onto the system. The 
in i tt ab file is scanned to find all entries that are to be 
processed for that run - level . 

Run - 1 ev el 2 is usually defined by the user to contain all of 
the terminal processes and daemons that are spawned in the 
multi-user environment. 

In a multi-user environment, the in i ttab file is usually set 
up so that in i t will create a process for each terminal on 
the system. 

For terminal processes, ultimately the shell will terminate 
because of an end-of-file either typed explicitly or gen- 
erated as the result of hanging up. When in i t receives a 
child death signal, telling it that a process it spawned has 
died, it records the fact and the reason it died in 
/etc/utmp and /etc/wtmp if it exists (see who ( 1 ) ) . A his- 
tory of the processes spawned is kept in /etc/wtmp if such a 
file exists. 
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To spawn each process in the in i t tab file, in i t reads each 
entry and for each entry which should be respawned, it forks 
a child process. After it has spawned all of the processes 
specified by the i n i 1 1 a b file, i n i t waits for one of its 
descendant processes to die, a powerfail signal, or until 
i n i t is signaled by init or te 1 i n i t to change the system’s 
run - leve l . When one of the above three conditions occurs, 
init re-examines the in i t t ab file. New entries can be added 
to the in i t tab file at any time; however, init still waits 
for one of the above three conditions to occur. To provide 
for an instantaneous response the init Q or init q command 
can wake init to re-examine the in i t tab file. 

If init receives a power fail signal ( S IGPWR ) and is not in 
SINGLE USER mode, it scans in i t tab for special powerfail 
entries. These entries are invoked (if the run - level s per- 
mit) before any further processing takes place. In this way 
init can perform various cleanup and recording functions 
whenever the operating system experiences a power failure. 
It is important to note that the powerfail entries should 
not use devices that must first be initialized (e.g. dzb 
lines) after a power failure has occurred. 

When * n j t is requested to change run - level s (via tel in i t ) , 
init sends the warning signal (SIGTERM) to all processes 
that are undefined in the target run - 1 ev el . Init waits 20 
seconds be fore forcibly terminating these processes via the 
kill signal ( SIGKILL ) . 

Tel in i t 

Te 1 i n i t , which is linked to / etc / init , is used to direct the 
actions of init . It takes a one character argument and sig- 
nals init via the kill system call to perform the appropri- 
ate action. The following arguments serve as directives to 
init . 

0-6 tells init to place the system in one of the 

run - levels 0-6 . 

a,b,c tells init to process only those /etc/inittab 
file entries having the a, b or c run - level 
set. 

Q,q tells init to re-examine the /etc/inittab 

file. 

s,S tells init to enter the single user environ- 

ment. When this level change is effected, the 
virtual system teletype, /dev/syscon, is 
changed to the terminal from which the command 
was executed. 
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Te 1 i n i t can only be run by someone who is super-user or a 
member of group sys. 


FILES 

/etc/inittab 
/etc/utmp 
/etc/wtmp 
/etc/ioctl .syscon 
/dev/ sysco n 
/ dev/svstty 

SEE ALSO 

getty(IM), login(l), sh( 1 ) , who(l), kill(2), inittab(4), 
utmp( 4 ) . 

DIAGNOSTICS 

If i n i t finds that it is continuously respawning an entry 
from /etc/inittab more than 10 times in 2 minutes, it will 
assume that there is an error in the command string, and 
generate an error message on the system console, and refuse 
to respawn this entry until either 5 minutes has elapsed or 
it receives a signal from a user in i t ( te 1 in i t ) . This 
prevents i n i t from eating up system resources when someone 
makes a typographical error in the in i ttab file or a program 
is removed that is referenced in the inittab. 
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NAME 

install - install comm and s 

SYNOPSIS 

/etc/install [r?c dira] [r-f dirb] [r-i] [r-n dire] [rro] Lrs] 
file [dirx ...] 

DESCRIPTION 

Inst al 1 is a command most commonly used in make f i 1 e s f ’ 

(see m ake ( 1 ) ) to install a f ile (updated target file) in a 
specific place within a file system. Each file is installed 
by copying it into the appropriate directory, thereby 
retaining the mode and owner of the original command. The 
program prints messages telling the user exactly what files 
it is replacing or creating and where they are going. 

If no options or directories ( dirx . ..) are given, install 
searches a set of default directories (/bin, /usr/bin, /etc, 
/lib, and /usr/lib, in that order) for a file with the same 
name as fil e. When the first occurrence is found, install 
issues a message saying that it is overwriting that file 
with file , and proceeds to do so. If the file is not found, 
the program states this and exits without further action. 

If directories ( dirx ...) are specified after file , they are 
searched before the directories specified in the default 
list. 

The meanings of the options are: 

~ c dira Installs a new command ( f i 1 e ) in the 

directory specified by dira , only if it 
is not found. if it is found, install 
issues a message saying that the file 
already exists, and exits without 
overwriting it. May be used alone or 
with the r-s option. 

•rf dirb Forces file to be installed in a given 

directory, whether or not one already 
exists. If the file being installed 
does not already exist, the mode and 
owner of the new file is set to 755 and 
bin, respectively. If the file already 
exists, the mode and owner is that of 
the already existing file. May be used 
alone or with the t-o or ^-s options. 

<ri Ignores default directory list, search-r 

ing only through the given directories 
( dirx ...). May be used alone or with 
options other than rC and -f. 
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~ n ^ i r c If file is not found in any of the 

searched directories, it is put in the 
directory specified in dire . The mode 
and owner of the new file is set to 755 
and bin, respectively. May be used 
alone or with options other than r?c and 
rf . 

*•0 If file is found, this option saves the 

'' found* 1 file by copying it to OLD f i 1 e 
in the directory in which it was found. 
This option is useful when installing a 
normally text busy file such as /bin/sh 
or /etc/getty, where the existing file 
cannot be removed. May be used alone or 
with options other than -c . 

r5 Suppresses printing of messages other 

than error messages. May be used alone 
or with any other options. 

SEE ALSO 

naked ) , mk(8). 
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NAME 

killall - kill all active processes 

SYNOPSIS 

/etc/killall [ signal ] 


DESCRIPTION 

Killall is is a procedure used by /etc/shutdown to kill all 
active processes not directly related to the shut down pro- 
cedure. 


Ki 1 1 al 1 is chiefly used to terminate all processes with open 
files so that the mounted file systems will be un busied and 
can be unmounted. 

Killall sends signal (see k i 1 1 ( 1 ) ) to all remaining 
processes not belonging to the above group of exclusions. 
If no s i gnal is specified, a default of 9 is used. 

FILES 

/etc/shutdown 


SEE ALSO 

kill(1), p s ( 1 ) , shutdown(IM), signal(2). 
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NAME 

link, unlink - exercise link and unlink system calls 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 


DESCRIPTION 

Link and u nlink perform their respective system calls 
their arguments, abandoning all error checking. These 
mands may only be executed by the super-user, who (it 
hoped) knows what he or she is doing. 

SEE ALSO 

rm(l), link(2), unlink(P). 


on 
com- 
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NAME 

lpadmin - configure the LP spooling system 
SYNOPSIS 

/usr / lib/lpadmin r-pprinter [options] 

/usr/ lib/lpadmin rxdest 
/usr/lib/lpadmin r d[dest] 

DESCRIPTION 

Lpadmin configures LP spooling systems to describe printers, 
classes and devices. It is used to add and remove destina- 
tions, change membership in classes, change devices for 
printers, change printer interface programs, and change the 
system default destination. Lpadmin may not be used when 
the LP scheduler, 1 psched ( 1 M) , is running, except where 
noted below. 

One of the r p , -d or -x options must be present for every 
legal invocation of 1 padmin . 

-d [ d e st 3 makes d est , an existing destination, the new 

system default destination. If dest is not 
supplied, then there is no system default 
destination. This option may be used when 
1 psched ( 1 M) is running. No other options are 
al lowed wi th -d . 

— x d e st removes destination dest from the LP system. 

If dest is a printer and is the only member 
of a class, then the class is deleted, too. 
No other options are allowed with -x . 

-»p pr int er names a printer to which all of the options 

below refer. If printer does not exist then 
it is created. 

The following options are only useful with -p and may appear 
in any order. For ease of discussion, the printer will be 
referred to as P below. 

— c c 1 ass inserts printer P into the specified class . 

Class is created if it does not already 
exist. 

-e pr in ter copies an existing printer * s interface pro- 

gram to be the new interface program for JP. 

-h indicates that the device associated with _P 

is hardwired. This option is assumed when 
creating a new printer, unless the —1 option 
i s suppl i ed . 

— 1 inter fa ce establishes a new interface program for P. 

Interface is the pathname of the new program. 
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-mmod el 


— r c 1 as s 


indicates that the device associated with J? 
is a login terminal. The LP scheduler, 
1 ps c he d , disables all login terminals 
automatically each time it is started. 
Before re-enabling P, its current device 
should be established using 1 padmin . 

selects a model interface program for _P. 
Mod el is one of the model interface names 
supplied with the LP software (see Mod el s 
below) . 

removes printer _P from the specified class . 
If _P is the last member of the class , then 
the class is removed. 


-y device associates a new device with printer _P. Dev- 

ice is the pathname of a file that is writ- 
able by the LP administrator, lj) . Note that 
there is nothing to stop an administrator 
from associating the same device with more 
than one pr inter . If only the -p and -v 

options are supplied, then 1 padm in may be 
used while the scheduler is running. 

Restrictions. 

When creating a new printer, the -v option and only one of 
the -e, -i or -m options must be supplied. The -h and -1 
keyletters are mutually exclusive. Printer and class names 
may be no longer than 14 characters and must consist 
entirely of the characters A-Z , a-z, 0-9 and (underscore). 


Mod els . 

Model printer interface programs are supplied with the LP 
software. They are shell procedures which interface between 
1 psc hed and devices. All models reside in the directory 
TusrV spool/ 1 p/mod el and may be used as is with 1 padmin -m . 
Alternatively, LP administrators may modify copies of models 
and then use 1 padm in — i to associate them with printers. 
The following list describes the mod el s and lists the 
options which they may be given on the 1 command line using 
the -o keyletter: 

dumb interface for a line printer without special func- 

tions and protocol. Form feeds are assumed. This 
is a good model to copy and modify for printers 
which do not have models. 

1640 Diablo 1640 terminal running at 1200 baud, using 

XON/XOFF protocol. Options: 

-12 12-pitch (10-pitch is the default) 

-f don’t use the 450 (1) filter. The output has 
been pre-processed by either 450 (1) or the 


2 


Printed 6 1985 



LPADMIN ( 1H) 


LPADMIN ( 1M) 


nr o f f 450 driving table. 

hp Hewlett Packard 263 1 A line printer at 2400 baud. 

Options: 

— c compressed print 
-e expanded print 

prx Printronix P300 printer using XON/XOFF protocol at 

1200 baud. 

EXAMPLES 

1. Assuming there is an existing Hewlett Packard 2631A line 
printer named hp2 , it uses the hp model interface after 
the command; 

/usr/lib/lpadmin -php2 -mhp 

2. To obtain compressed print on hp2 , use the command: 

lp -dhp2 -o-c files 

3. A Diablo 1640 printer called st 1 can be added to the LP 
configuration with the command; 

/ us r / 1 i b / 1 padm in -pstl -v/dev/tty20 -ml640 

4. An nrof f document may be printed on st 1 in any of the 
following ways: 


nroff 

-T45 0 files ! 

lp 

-dstl -of 

nr o f f 

-T450-12 files 

1 

1 

lp -dstl -of 

nroff 

-T 37 files i 

col 

i lp -dstl 

5. The following 

command prints 

the 

password file on s_t1 in 


1 2-pi t c h : 

lp — d s 1 1 -o12 /etc/passwd 

NOTE : the -12 option to the 1640 model should never be 
used in conjunction with nro f f . 

FILES 

/usr/spool/lp/* 

SEE ALSO 

450 ( 1 ), accept(IM) , enable(l), lp(1), lpsched(IM), 
lpstat(l), "LP Spooling System" in Adm in i str ator 1 s Guide. 
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NAME 

lpsched, lpshut, lpmove - start/stop the LP request 
scheduler and move requests 

SYNOPSIS 

/usr/lib/lpsched 
/usr/lib/lpshut 
/usr/lib/lpmove requests dest 
/ usr / 1 ib/ 1 pmov e destl dest2 

DESCRIPTION 

Lpsched schedules requests taken by JL_p( 1 ) for printing 
online printers. 

Lpshut shuts down the line printer scheduler. All printers 
that are printing at the time 1 pshu t is invoked stop print- 
ing. Requests that were printing at the time a printer was 
shut down are reprinted in their entirety after lpsched is 
started again. All LP commands perform their functions even 
when lpsched is not running. 

Lpmo v e moves requests that were queued by Ij>( 1 ) between LP 
destinations. This command may be used only when lpsched is 
not r unn ing . 

The first form of the command moves the named requests to 
the LP destination, dest . Requests are request ids as 
returned by l_p . The second form moves all requests for des- 
tination destl to destination d est2 . As a side effect, 1 p 
rejects requests for destl . 

Note that 1 pmov e never checks the acceptance status (see 
accept ( 1 M) ) for the new destination when moving requests. 


FILES 

/usr/spool/lp/* 

SEE ALSO 

accept(IM), enabled), lp(1), lpadmin(IM), lpstat(l), "LP 
Spooling System" in Admin i str a tor 1 s Guide. 
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NAME 

it. kfs - construct a file system 

SYNOPSIS 

/etc/mkfs special b 1 oc ks [ : i nod e s ] [gap blocks/cyl] 

/etc/mkfs special proto [gap blocks/cyl] 

DESCRIPTION 

Mkf s constructs a file system by writing on the special file 
according to the directions found in the remainder of the 
command line. If the second argument is given as a string 
of digits, mkf s builds a file system with a single empty 
directory on it. The size of the file system is the value of 
blocks interpreted as a decimal number. This is the number 
of physi cal disk blocks the file system will occupy. The 
boot program is left uninitialized. If the optional number 
of inodes is not given, the default is the number of logical 
blocks divided by 4. 

If the second argument is a file name that can be opened, 
mkf s assumes it to be a prototype file pro to , and will take 
its directions from that file. The prototype file contains 
tokens separated bv spaces or new-lines. The first token is 
the name of a file to be copied onto block zero as the 
bootstrap program (see unixboot ( 8 ) ) . The second token is a 
number specifying the size of the created file system in 
phy sical disk blocks. Typically it will be the number of 
blocks on the device, perhaps diminished by space for swap- 
ping. The next token is the number of inodes in the file 
system. The maximum number of inodes configurable is 65500. 
The next set of tokens comprise the specification for the 
root file. File specifications consist of tokens giving the 
mode, the user ID, the group ID, and the initial contents of 
the file. The syntax of the contents field depends on the 
mod e . 

The mode token for a file is a 6 character string. The 
first character specifies the type of the file. (The char- 
acters -bed specify regular, block special, character spe- 
cial and directory files respectively.) The second character 
of the type is either u or - to specify set-user-id mode or 
not. The third is g or - for the set-group-id mode. The 
rest of the mode is a three digit octal number giving the 
owner, group, and other read, write, execute permissions 
( see c hmod ( 1 ) ) . 

Two decimal number tokens come after the mode; they specify 
the user and group ID's of the owner of the file. 

If the file is a regular file, the next token is a path name 
whence the contents and size are copied. If the file is a 
block or character special file, two decimal number tokens 
follow which give the major and minor device numbers. If 
the file is a directory, mkf s makes the entries . and 
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and then reads a list of names and (recursively) file 
specifications for the entries in the directory. The scan 
is terminated with the token $. 

A sample prototype specification follows: 

/stand / d i s kboo t 
4872 1 1 0 


d — 7 7 7 3 
usr d — 
sh 

1 

777 3 1 
755 

3 

1 

/ bin/ sh 

ken 

d — 75 5 

6 

1 


bO 

$ 

b — 644 

3 

1 

0 0 

cO 

c — 6 4 4 

3 

1 

0 0 


$ 

$ 

In both command syntaxes, the rotational gap and the number 
of bloc ks/ cyl can be specified. 

SEE ALSO 

dir(4), fs(4), unixboot(8). 

BUGS 

If a prototype is used, it is not possible to initialize a 
file larger than 64K bytes, nor is there a way to specify 
links . 
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NAME 

mknod - build special file 

SYNOPSIS 

/bin/mknod name c ! b major minor 
/bin/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for a 
special file. The first argument is the name of the entry. 
In the first case, the second is b if the special file is 
block-type (disks, tape) or c if it is character-type (other 
devices). The last two arguments are numbers specifying the 
major device type and the m ino r device (e.g. unit, drive, or 
line number), which may be either decimal or octal. 

The assignment of major device numbers is specific to each 
system. They have to be dug out of the system source file 

conf ,c . 

Mkn od can also be used to create fifo’s (a.k.a named pipes) 
(second case in SYNOPSIS above) . 

SEE ALSO 

mknod ( 2 ) . 
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NAME 

mount, amount - mount and dismount file system 
SYNOPSIS 

/bin/mount [ special directory [ -r ] ] 

/bin/umount special 
DESCRIPTION 

Mo un t announces to the system that a removable file system 
is present on the device spec ial . The directory must exist 
already; it becomes the name of the root of the newly 
mounted file system. 

These commands maintain a table of mounted devices. If 
invoked with no arguments, moun t prints the table. 

The optional last argument indicates that the file is to be 
mounted read-only. Physically write-protected and magnetic 
tape file systems must be mounted in this way or' errors will 
occur when access times are updated, whether or not any 
explicit write is attempted. 

Umoun t announces to the system that the removable file sys- 
tem previously mounted on device spec ial is to be removed. 

FILES 

/etc/mnttab mount table 

SEE ALSO 

setmnt(IM), mount(2), mnttab(4). 

DIAGNOSTICS 

Mount issues a warning if the file system to be mounted is 
currently mounted under another name. 

Umoun t complains if the special file is not mounted or if it 
is busy. The file system is busy if it contains an open 
file or some user’s working directory. 


BUGS 

Some degree of validation is done on the file system, how- 
ever it is generally unwise to mount garbage file systems. 
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NAME 

m v d i r - move a directory 

SYNOPSIS 

/etc/mvdir dirname name 
DESCRIPTION 

Mv d i r renames directories within a file system. Dirname 
must be a directory; name must not exist. Neither name may 
be a sub-set of the other (/x/y cannot be moved to /x/y/z, 
nor vice versa). 

Only super-user can use m vd ir . 

SEE ALSO 

mkd ir ( 1 ) . 
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NAME 

ncheck - generate names from i-numbers 

SYNOPSIS 

/bin/ncheck C -i numbers ] [ -a ] [ -s ] [ file-system ] 

DESCRIPTION 

No he c k with no argument generates a path name vs. i-number 
list of all files on a set of default file systems. Names 
of directory files are followed by /.. The -i option 
reduces the report to only those files whose i-numbers fol- 
low. The -a option allows printing of the names . and . ., 
which are ordinarily suppressed. The — s option reduces the 
report to special files and files with set-user-ID mode; it 
is intended to discover concealed violations of security 
pol icy . 

A file system may be specified. 

The report is in no useful order, and probably should be 
sorted . 

SEE ALSO 

f sck( 1 M) , sor t( 1 ) . 

DIAGNOSTICS 

When the file system structure is improper, ?? denotes the 
''parent’’ of a parentless file and a path name beginning 
with ... denotes a loop. 
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NAME 

prfld, prfstat, prfdc, prfsnap, prfpr - operating system 
pr o f i 1 er 

SYNOPSIS 

/etc/prfld [ namelist ] 

/etc/prfstat [ on ! off ] 

/etc/prfde file [ period [ off-hour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ namelist ] ] 

DESCRIPTION 

Prfld , p rfstat , pr f d c , p rfsnap , and pr f p r form a group of 
programs to facilitate an activity study of the operating 
system . 

Pr fld initializes the recording mechanism in the system. It 
generates a table containing the starting address of each 
system subroutine as extracted from namelist . 

Prfstat enables or disables the sampling mechanism. Pro- 
filer overhead is less than 1 % as calculated for 500 text 
addresses. Prfstat also reveals the number of text 
addresses being measured. 

Pr f d c and pr f sna p perform the data collection function of 
the profiler by copying the current value of all the text 
address counters to a file where the data can be analyzed. 
Pr f d c stores the counters in file every per iod minutes and 
turns off at off ho ur (valid values for o ff hour are 0 - 24 ). 
Prfsnap collects data at the time of invocation only, 
appending the counter values to file . 

Prfpr formats the data collected by pr fd c o r pr f snap . Each 
text address is converted to the nearest text symbol (as 
found in namelist ) and is printed if the percent activity 
for that range is greater than cutoff . 


FILES 

/ d ev/ pr f 
/ un i x 

SEE ALSO 

pr f (7 ) . 


interface to profile data and text addresses 
default for namelist file 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

/ etc/ pwck [file] 

/etc/gr pck [ fi 1 e] 

DESCRIPTION 

Pwc k scans the password file and notes any inconsistencies. 
The checks include validation of the number of fields, login 
name, user ID, group ID, and whether the login directory and 
optional program name exist. The criteria for determining a 
valid login name is derived from Setting up the UNIX System 
in the UNIX Sy stem Administrator * s Guide . The default pass- 
word file is /etc/passwd. 

Grpck verifies all entries in the group file. This verifica- 
tion includes a check of the number of fields, group name, 
group ID, and whether all login names appear in the password 
file. The default group file is /etc/group. 


FILES 

/etc. / group 
/ etc/passwd 

SEE ALSO 

group(4), passwd(4). 

Setting up the UNIX System in UNIX System Adm in i st r ator ’ _s 
Guide. 


DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

runacct - run daily accounting 

SYNOPSIS 

/usr/lib/acct/runacct [mmdd [state]] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is 
normally initiated via cron ( 1 M ) . Runacct processes connect, 
fee, disk, and process accounting files. It also prepares 
summary files for prdailv or billing purposes. 

Runacc t takes care not to damage active accounting files or 
summary files in the event of errors. It records its prorr 
gress by writing descriptive diagnostic messages into 
active. When an error is detected, a message is written to 
/dev/ consol e , mail (see mai 1 ( 1 ) ) is sent to root and adm , 
and runacct terminates. Pun ac c t uses a series of lock files 
to protect against r e-invoc ation . The files lock and lockl 
are used to prevent simultaneous invocation, and lastdate is 
used to prevent more than one invocation per day. 

Runacct breaks its processing into separate, restartable 
states using statefile to remember the last state completed. 
It accomplishes this by writing the state name into star- 
tefile. Runacct then looks in statefile to see what it has 
done and to determine what to process next. State s are exer 
cuted in the following order: 

SETUP Move active accounting files into working 

files. 

WTMPFIX Verify integrity of wtmp file, correcting 

date changes if necessary. 

C0NNECT1 Produce connect session records in ctmp.h 
format . 

C0NNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into 

tacc t ,h format . 

MERGE Merge the connect and process accounting 

record s . 

FEES Convert output of chargefee into tacct.h 

format and merge with connect and process 
accounting records. 

DISK Merge disk accounting records with connect, 

process, and fee accounting records. 
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MERGETACCT Merge the daily total accounting records in 
daytacct with the summary total accounting 
records in /usr/adm/acct/sum/ tacct . 

CMS Produce command summaries. 

USEREXIT Include any installatio nr- dependent account- 

ing programs here. 

CLEANUP Cleanup temporary files and exit. 

To restart r unacc t after a failure, first check the active 

file for diagnostics, then fix any corrupted data files such 
as pacct or wtmp. The lock files and lastdate file must be 
removed before runacct can be restarted. The argument mm d d 
is necessary if runacct is being restarted, and specifies 
the month and day for which runacct reruns the accounting. 
Entry point for processing is based on the contents of sta? 
tefile; to override this, include the desired state on the 
command line to designate where processing should begin. 

EXAMPLES 

To start runacct . 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct . 

nohup runacct 0601 2>> /usr/adm/acct/nite/fd21og & 

To restart runac ct at a specific state . 

nohup runacct 6601 MERGE 2>> /usrTSdm/ acct/ni te/fd21og & 

FILES 

/ et c / wtm p 
/ usr/adm/pacct* 

/usr/src/ cm d/ ac c t/ 1 a c c t . h 
/ usr/src/ cmd/acct/ctmp ,h 
/us r / adm/ acct/nite/active 
/ usr/adm/acct/nite/daytacct 
/ usr/ adm/acct/ nite/lock 
/usr/adm/acct/nite/lockl 
/usr/adm/acct/ni te/lastdate 
/ usr /adm/ acct/ni te/ state file 
/usr/adrn/acct/nite/ptacct* . mmdd 

SEE ALSO 

acct(IM), acctcms(IM), acctcom(l), acctcon(IM), 

acc tmerg ( 1 M) , acctprc(IM), acctsh(IM), cron(IM), fwtmp(IM), 
acct(2), acct(4), utmp(4). 

''Accounting’’ in the Adm in i str a tor 1 s Guide . 

DIAGNOSTICS 

The accounting system starts complaining with ***RECOMPILE 
pnpspli t WITH NEW HOLIDAYS*** after the last holiday of the 
year. See ''Accounting’’ in the Administrator’ s Guide for 
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more on how to correct this condition. Other diagnostics 
are placed in various error and log files. 


BUGS 

Normally it is not a good idea to restart r un ac c t in the 
SETUP sta te . Run SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state , remove the last 
ptacct file because it is not complete. 
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NAME 

sal, sa2, sadc - system activity report package 

SYNOPSIS 

/usr/lib/sa/sadc [t n] [ofile] 

/usr /lib/sa/sa 1 [t n] 

/usr / lib/sa/ sa2 C-ubdycwaqvm ] [-s time] [~e time] [-i sec] 
DESCRIPTION 

System activity data can be accessed at the special request 
of a user (see sar ( 1 ) ) and automatically on a routine basis 
as described here. The operating system contains a number 
of counters that are incremented as various system actions 
occur. These include CPU utilization counters, buffer usage 
counters, disk and tape I/O activity counters, TTY device 
activity counters, switching and system-call counters, 
file-access counters, queue activity counters, and counters 
for inter-process communications. 

Bade and shell procedures sa 1 and sa,? are used to sample, 
save and process this data. 

Sad c , the data collector, samples system data n times every 
_t seconds and writes in binary format to ofile or to 
standard output. If t and n are omitted, a special record 
is written. This facility is used at system boot time to 
mark the time at which the counters restart from zero. The 
/etc/rc entry: 

su sys -c ’’/usr/lib/sa/sadc /usr/adm/sa/sadate +$d&’’ 

writes the special record to the daily data file to mark the 
system restart. 

The shell script sal , a variant of sad c , is used to collect 
and store data in binary file /usr/adm/sa/sad[d where d_d is 
the current day. The arguments t and n cause records to be 
written n times at an interval of t seconds, or once if 
omitted. The entries in crontab (see cron ( 1 M ) ) : 

0 * * * 0,6 su sys -c ”/usr/lib/sa/sa 1 " 

0 8-17 » * 1-5 su sys -c "/usr/lib/sa/sa 1 1200 3" 

0 18-7 * * 1-5 su sys -c ”/usr/lib/sa/sa 1 ” 

produces records every 20 minutes during working hours; 
otherwise; it is on an hourly basis. 

The shell script sa 2 , a variant of sar ( 1 ) , writes a daily 
report in file /usr / adm/ sa/ sar djd . The options are explained 
in sar ( 1 ) . The crontab entry: 
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5 18 * * 1-5 su adm -c "/usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 
360 0 -'A” 

reports important activities hourly during the working day. 
The structure of the binary daily data file is: 
struct sa { 

struct sysinfo si; /* see /usr/include/sys/sysinfo.h */ 


in t 

s zi nod e ; 

/* 

current 

entries of 

inod e 

table 

*/ 

in t 

szf i 1 e ; 

/* 

current 

entries of 

file 

table 

*/ 

in t 

sztex t ; 

/* 

current 

entries of 

text 

table 

*/ 

i n t 

szproc; 

/« 

current 

entries of 

proc 

table 

*/ 

in t 

mszinode; 

/* 

size of 

inode table 

*/ 



in t 

m szf i 1 e ; 

/« 

size of 

file table 

»/ 



in t 

m sztex t ; 

/* 

size of 

text table 

*/ 



i n t 

mszproc; 

/* 

size of 

proc table 

*/ 



long 

inod eo v f ; 

/* 

cumul . 

overflows of 

inode table 

*/ 

long 

inod eov f ; 

/* 

cumul . 

overflows of 

file 

table 

*/ 

long 

te x to v f ; 

/* 

cumul . 

overflows of 

text 

table 

*/ 

long 

procov f ; 

/* 

cumul . 

overflows of 

proc 

table 

*/ 

time 

t t s ; 

/* 

time stamp, seconds 

*/ 



long 

dev io [ NDE VS ] [ 4 ] ; 

/* device info for 

up to NDEVS 

units 


//define I0_0PS 0 /* cumul. I/O requests */ 

//define T0_BCNT 1 /*. cumul. blocks transferred */ 

//define I0__ACT 2 /* cumul. drive busy time in ticks */ 

//define IO__RESP 3 /* cumul. I/O resp time in ticks */ 

} ; 

FILES 

/usr/adm/sa/sadd 
/usr/adm/sa/ sar d d 
/tmp/sa . ad r f 1 

SEE ALSO 

sag(IG), sar(1), timex(l), "System Activity Package" in 
Administrator's Guide. 


daily data file 
daily report file 
address file 
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NAME 

setmnt - establish mount table 

SYNOPSIS 

/etc/se tmnt 


DESCRIPTION 

Setmnt creates the /etc/mnttab table (see mnt tab ( *4 ) ) , which 
is needed for both the moun t ( 1 M) and umoun t commands. 
Setmnt reads standard input and creates a mnt tab entry for 
each line. Input lines have the format: 

f i 1 esvs nod e 


where f i 1 e sy s is the name of the file system’s spec ial file 
(e.g., rp??’’) and nod e is the root name of that file sys- 
tem. Thus f i 1 e sy s and node become the first two strings in 
the mnttab (4 ) entry. 

FILES 

/etc/mnttab 


SEE ALSO 

mnt tab ( 4 ) . 


BUGS 

Evil things will happen if f i 1 esys or node are longer than 
10 characters. 

Setmnt silently enforces an upper limit on the maximum 
number of mnttab entries. 
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NAME 

shutdown - terminate all processing 

SYNOPSIS 

/etc/shutdown 

DESCRIPTION 

Shutdow n is part of the UNIX System operation procedures. 
Its primary function is to terminate all currently running 
processes in an orderly and cautious manner. The procedure 
is designed to interact with the operator (i.e., the person 
who invoked shutdown ) . Shutdown may instruct the operator 
to perform some specific tasks, or to supply certain 
responses before execution can resume. Shutdown goes 
through the following steps: 

All users logged on the system are notified to log off 
the system by a broadcasted message. The operator may 
display his/her own message at this time. Otherwise, the 
standard file save message is displayed. 

If the operator wishes to run the file-save procedure, 
shutdown unmounts all file systems. 

All file systems’ super blocks are updated before the 
system is to be stopped (see sync ( 1 ) ) . This must be done 
before re-booting the system, to insure file system 
integrity. The most common error diagnostic that will 
occur is device busy . This diagnostic happens when a 
particular file system could not be unmounted. 

SEE ALSO 

moun t ( 1 M ) , sync ( 1 ) . 
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NAME 

svsdef - system definition 


SYNOPSIS 

/etc/sysdef [ opsvs [ master ] ] 


DESCRIPTION 

Sy s d e f analyzes the named operating system file and extracts 
configuration information; this includes all hardware dev- 
ices as well as system devices and all tunable parameters. 


The output of s y sd e f can usually be used directly by 
con f i g ( 1 M ) to regenerate the appropriate configuration 
files. 


FILES 

/unix default operating system file 

/etc/master default table for hardware specifications 


SEE ALSO 

config(IM) , master(M) . 


BUGS 

For devices that have interrupt vectors but are not 
interrupt-driven, the output of s vsd e f cannot be used for 
con f i g . Because information regarding c o n f i g aliases is not 
preserved by the system, device names returned might not be 
accurate . 
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NAME 

uuclean - uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uuclean [ options ] 

DESCRIPTION 

Uuclean scans the spool directory for files with the speci- 
fied prefix and deletes all those which are older than the 
specified number of hours. 

The following options are available. 

-d d ir ec tory Cleans director y instead of the spool direc- 
tory. 

Scans for files with pr e as the file prefix. 
Up to 10 -p arguments may be specified. A -p 
without any pr e following causes all files 
older than the specified time to be deleted. 

Deletes files whose age is more than time 
hours, if the prefix test is satisfied, 
(default time is 72 hours) 

Finds files which are older than time hours; 
however, the files are not deleted. If the 
argument file is present, the warning is placed 
in file ; otherwise, the warnings go to the 
stand ar d out put . 

Examines only files destined for system sys . 
Up to 10 -s arguments may be specified. 

Sends mail to the owner of the file when it is 
deleted. If a f i 1 e is specified, then an entry 
is placed in file . 

This program is typically started by cron ( 1M) . 

FILES 

/usr/lib/uucp (directory with commands used by uucl ean 

internally) 

/usr / spool /uuc p (spool directory) 

SEE ALSO 

cron(IM), uucp(IC), uux(IC). 


*»P P r e 

-n time 

-w f i 1 e 

-s sy s 

-mf i 1 e 
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NAME 

uusub - monitor uucp network 

SYNOPSIS 

/usr / lib/uucp/uusub [ options ] 

DESCRIPTION 

Uusub defines a juuc p subnetwork and monitors the connection 
and traffic among the members of the subnetwork. The fol- 
lowing options are available: 

Add s ys to the subnetwork. 

Delete sys from the subnetwork. 

Report the statistics on connections. 

Report the statistics on traffic amount. 

Flush the connection statistics. 

Gather the traffic statistics over the past hr 
hours. 

Exercise the connection to the system sys . If sys 
is specified as all, then exercise the connection to 
all the systems in the subnetwork. 

The meanings of the connections report are: 

sys # c a 1 1 // ok time //d ev # log i n ff nac k o ther 

where sys is the remote system name, it cal l is the number of 
times the local system tries to call sys since the last 
flush was done, // ok is the number of successful connections, 
time is the latest successful connect time, // dev is the 
n Urn'S er of unsuccessful connections because of no available 
device (e.g., ACU), // login is the number of unsuccessful 
connections because of login failure, // n a c k is the number of 
unsuccessful connections because of no response (e.g., line 
busy, system down), and // other is the number of unsuccessful 
connections because of other reasons. 

The meanings of the traffic statistics are: 

s f i 1 e sbyt e r f i 1 e rbyte 

where s f i 1 e is the number of files sent and sby t e is the 
number of bytes sent over the period of time indicated in 
the latest uusub command with the -uhr option. Similarly, 
r f i 1 e and rbyte are the numbers of files and bytes received. 

The comm and : 

uusub -c all -u 24 

is typically started by cron ( 1 M) once a day. 

FILES 


~a sys 
— d s vs 

-1 

~r 

-f 

-Uhr 

"Csys 
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/usr/spool/uucp/SYSLOG 

system log f i 1 e 
/ usr/lib/uucp/L^sub 

connection statistics 
/usr/lib/uucp/P^sub 

traffic statistics 

SEE ALSO 

uuc p( 1C), uustat(IC). 
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NAME 

volcopy, labelit - copy file systems with label checking 
SYNOPSIS 

/etc/volcopy [options] fsname speciall volnamel special2 
volname? 

/etc/labelit special [ fsname volume [ -n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a 
blocksize matched to the device. Options are: 

-a invoke a verification sequence requiring a posi- 
tive operator response instead of the standard 10 
second delay before the copy is made, 

~s (default) invoke the DEL if wrong verification 
sequence . 

Other o pt i on s are used only with tapes: 

-bpidensity bi ts-per-inch (i.e., 800/1600), 

-feetsize size of reel in feet (i.e., 1200/2400), 

— reelnum beginning reel number for a restarted 

copy , 

-buf use double buffered 1/0. 

The program requests length and density information if it is 
not given on the command line or is not recorded on an input 
tape label. If the file system is too large to fit on one 
reel, vol copy will prompt for additional reels. Labels of 
all reels are checked. Tapes may be mounted alternately on 
two or more drives. 

The f sn ame argument represents the mounted name (e.g.: root, 
usr , etc.) of the filsvstem being copied. 

The s P ec i al should be the physical disk section or tape 

(e.g.: /dev/rd sk/ cOdOs 1 , /dev/rmt__rwd , etc.). 

The v °lname is the physical volume name (e.g.: si, s3» etc.) 
and should match the external label sticker. Such label 
names are limited to six or fewer characters. Vol name may 
be - to use the existing volume name. 

Spec iall and volnam el are the device and volume from which 
the copy of the file system is being extracted. Spec ia!2 
and vol nam e2 are the target device and volume. 

Fsname and v ol nam e are recorded in the last 12 characters of 
the superblock (char fsname[6], volname[ 6 ] ; ) . 

Labelit can be used to provide initial labels for unmounted 
disk or tape file systems. With the optional arguments 
omitted, labelit prints current label values. The ~n option 
provides for initial labeling of new tapes only (this 
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destroys previous contents) . 

EXAMPLES 

These ex am pies show how to use volcopy for backing up onto 
cartridge tape. Use 1000 feet for the size of reel with XL 
(450 feet/track) cartridge tapes. Use 600 feet for the size 
of reel with standard (300 feet/track) cartridge tapes. 
First use labelit to label as many cartridge tapes as you 
feel will be necessary for backing up (for example, three 
standard tapes are required to backup a full /usr filesys- 
tem) 

labelit /dev/rmt_rwd usr s3 -n 

Now execute the volcopy command: 

volcopy usr /dev/rd sk/c0d0s3 s3 /d ev/rm t_rwd - 

The system will respond with: 

Enter size of reel in feet for <->: 1000 

Tape density (ie, 800 ! 1600 i 6250)? 1600 

Peel 0, 1000 feet, 1600 BPT 

You will need 3 reels. 

( The same size and density is expected for all reels) 
From: /dev/rd sk/c0d0s3 . to /dev/rmt_rwd? ( DEL if wrong) 

Writing HEEL 1 of 3, VOL = - 


FILES 

/ e t c / 1 og / f i 1 e sa v e . 1 og a record of file s ys tern s/ vol urn es 

copied 

SEE ALSO 

f s ( 4 ) . 
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BUGS 

Tape record sizes are determined both by density and by 
drive type. 

Both volcopv and labelit must be used with rewind devices; 
non-rewind devices won’t work. 

The density 6250 for cartridge tape won’t work. 

The -n option to labelit puts the wrong date and a minus 
number for the number of inodes. Volcopy, however, corrects 
these after it has written the header at the beginning of 
the cartridge tape. 

Labelit reports twice as many blocks as there actually are. 
All of the UNIX utilities, with the exception of mkfs, 
report blocks in 512-byte blocks. This is because AT&T does 
it this way. 
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NAME 

wall ~ write to all users 


SYNOPSIS 

/ etc / wal 1 


DESCRIPTION 

Wall reads its standard input until an end-of-rfile. It then 
sends this message to all currently logged in users preceded 
by : 


Broadcast Message from ... 


It is used to warn all users, typically prior to shutting 
down the system. 


The sender must be superruser to override any protections 
the users may have invoked (see mes g ( 1 ) ) . 

FILES 

/dev/tty* 

SEE ALSO 

m esg ( 1 ) , write(l). 


DIAGNOSTICS 

''Cannot send to . when the open on a user’s tty file 

fails. 
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NAME 

whodo -> who is doing what 

SYNOPSIS 

/ e tc / whod o 

DESCRIPTION 

Whod o produces merged, reformatted, and dated output 
the who ( 1 ) and ps ( 1 ) commands. 

SEE ALSO 

ps ( 1 ) , who ( 1 ) . 


from 
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NAME 

intro - introduction to special files 

DESCFIPTION 

This section describes various special files that refer to 
specific hardware peripherals and UNIX System device 
drivers. The names of the entries are generally derived 
from names for the hardware, as opposed to the names of the 
special files themselves. Characteristics of both the 
hardware device and the corresponding UNIX System device 
driver are discussed where applicable. 

BUGS 

While the names of the entries generally refer to vendor 
hardware names, in certain cases these names are seemingly 
arbitrary for various historical reasons. 
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NAME 

cat - pho to t v pe se t ter interface 

DESCRIPTION 

Cat provides the interface to a Wang Laboratories, Inc. 
C/A/T pho to t ype se t ter . Bytes written on the file specify 
font, size, and other control information as well as the 
characters to be flashed. The coding will not be described 
here. 

Only one process may have this file open at a time. It is 
wr i te-onl y . 


FILES 

/dev/ cat 

SEE ALSO 

troff ( 1 ) . 
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NAME 

err - error-logging interface 

DESCRIPTION 

Minor device 0 of the err driver is the interface between a 
process and the system’s error-record collection routines. 
The driver may be opened only for reading by a single pro- 
cess with super-user permissions. Each read causes an 
entire error record to be retrieved; the record is truncated 
if the read request is for less than the record’s length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon( 1M) . 
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NAME 

mem, kmem - core memory 

DESCRIPTION 

Mem is a special file that is an image of the core memory of 
the computer. It may be used, for example, to examine and 
even to patch the system. 

Byte addresses in m em are interpreted as memory addresses. 
References to non-existent locations cause errors to be 
returned . 

Examining and patching device registers is likely to lead to 
unexpected results when read-only or write-only bits are 
present. 

The file kmem is the same as m em except that kernel virtual 
memory rather than physical memory is accessed. 


FILES 

/dev/mem, /dev/kmem 


BUGS 

Mem does not access addresses outside of physical ram 
memory; hence, no device registers are available. 
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NAME 

null - the null file 

DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 
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NAME 

prf - operating system profiler 

DESCRIPTION 

The file prf provides access to activity information in the 
operating system. Writing the file loads the measurement 
facility with text addresses to be monitored. Beading the 
file returns these addresses and a set of counters indica- 
tive of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and 
samples the program counter at line frequency. Samples that 
catch the operating system are matched against the stored 
text addresses and increment corresponding counters for 
later processing. 

The file prf is a pseudo-device with no associated hardware. 

FILES 

/ d ev/ pr f 

SEE ALSO 

config(IM) , profiler(IM) . 
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NAME 

termio - general terminal interface 

DESCRIPTION 

All of the asynchronous communications ports use the same 
general interface, no matter what hardware is involved. The 
remainder of this section discusses the c ommon features of 
this interface. 

When a terminal file is opened, it normally causes the pro- 
cess to wait until a connection is established. In prac- 
tice, users' programs seldom open these files; they are 
opened bv get t y and become a user's standard input, output, 
and error files. The very first terminal file opened by the 
process group leader of a terminal file not already associ- 
ated with a process group becomes the control terminal for 
that process group. The control terminal plays a special 
role in handling quit and interrupt signals, as discussed 
below. The control terminal is in he ri ted by a child process 
during a for k ( 2 ) . A process can break this association by 
changing its process group using setpgr p ( 2 ) . 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only lost 
when the system's character input buffers become completely 
full, which is rare, or When the user has accumulated the 
maximum allowed number of input characters that have not yet 
been read by some program. Currently, this limit is 256 
characters. When the input limit is reached, all the saved 
characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A 
line is delimited by a new-line (ASCII LF) character, an 
end-of-file (ASCII EOT) character, or an end-of-line charac- 
ter. This means that a program attempting to read will be 
suspended until an entire line has been typed. Also, no 
matter how many characters are requested in the read call, 
at most one line will be returned. It is not, however, 
necessary to read a whole line at once; any number of char- 
acters may be requested in a read, even one, without losing 
information. 

During input, erase and kill processing is normally done. 
By default, the character # erases the last character typed , 
except that it will not erase beyond the beginning of the 
line. By default, the character kills (deletes) the entire 
input line, and optionally outputs a new-line character. 
Both these characters operate on a key-stroke basis, 
independently of any backspacing or tabbing that may have 
been done. Both the erase and kill characters may be 
entered literally by preceding them with the escape 


1 


Printed 6 1985 


TERM 10 ( 7 ) 


(6/29/83) 


TERMIO (7 ) 


character ( \ ) . In this case the escape character is not 
read. The erase and kill characters may be changed. 

Certain characters have special functions on input. These 
functions and their default character values are summarized 
as fol lows : 

INTP (Rubout or ASCII DEL) generates an interrupt signal 
which is sent to all processes with the associated 
control terminal. Normally, each such process is 
forced to terminate, but arrangements may be made 
either to ignore the signal or to receive a trap to 
an agreed-upon location; see signal ( 2 ) . 

QUIT (Control- 1 , or ASCII FS) generates a quit signal. 

Its treatment is identical to the interrupt signal 
except that, unless a receiving process has made 
other arrangements, it will not only be terminated 
but a core image file (called core) will be created 
in the current working directory. 

ERASE ( // ) erases the preceding character. It will not 

erase beyond the start of a line, as delimited by a 
NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, 
EOF, or EOL character. 

EOF (Control-d or ASCII EOT) may be used to generate an 

end-of-file from a terminal. When received, all the 
characters waiting to be read are immediately passed 
to the program, without waiting for a new-line, and 
the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at 
the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file indi- 
cation. 

NL (ASCII LF) is the normal line delimiter. It can not 

be changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter, like 

NL. It is not normally used. 

STOP (Control-s or ASCII DC3) can be used to temporarily 
suspend output. It is useful with CRT terminals to 
prevent output from disappearing before it can be 
read. While output is suspended, STOP characters 
are ignored and not read. 

START (Control-q or ASCII DC1) is used to resume output 

which has been suspended by a STOP character. While 
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output is not suspended, START characters are 
ignored and not read. The start/stop characters can 
not be changed or escaped. 


The character values for INT R , QUIT, ERASE, KILL, EOF, and 
EOL may be changed to suit individual tastes. The ERASE, 
KILL, and EOF characters may be escaped by a preceding \ 
character, in which case no special function is done. 

When the carrier signal from the data-set drops, a hangup 
signal is sent to all processes that have this terminal as 
the control terminal. Unless other arrangements have been 
made, this signal causes the processes to terminate. If the 
hangup signal is ignored, any subsequent read returns with 
an end-of-file indication. Thus programs that read a termi- 
nal and test for end-of-file can terminate appropriately 
when hung up on. 

When one or more characters are written, they are transmit- 
ted to the terminal as soon as previously-written characters 
have finished typing. Input characters are echoed by put- 
ting them in the output queue as they arrive. If a process 
produces characters more rapidly than they can be typed, it 
will be suspended when its output queue exceeds some limit. 
When the queue has drained down to some threshold, the pro- 
gram i s r e sum ed . 


Several ioctl (2) system calls apply to terminal files. The 
primary calls use the following structure, defined in 
< termio .h> : 


# d e f i n e 
struct 


NCC 8 
termio { 


un si gned 
unsigned 
unsigned 
un si gned 
char 

unsigned 


short 

short 

short 

short 

c__l i n e 

char 


c_iflag;/* input modes */ 
c__oflag;/* output modes */ 
c^cflag;/* control modes */ 
c__lflag;/* local modes * / 

/* line discipline */ 
c cc[NCC];/* control chars */ 


The special control characters are defined by the array 
c cc . The relative positions and initial values for each 
function are as follows: 


0 TNTR DEL 

1 QUIT FS 

2 ERASE # 

3 KILL 6 

4 EOF EOT 

5 EOL NUL 


6 reserved 

7 reserved 
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The c i f I a g field describes the basic terminal input con- 

trol : 


IGNBPK 

BFKINT 

IGNPAR 

PAPMPK 

TNPCK 

ISTPIP 

INLCR 

TGNCP 

ICRNL 

IUCLC 

IXON 

IXANY 

IXOFF 


0000001 
0000002 
0000004 
000001 0 
0000020 
0000040 
00001 00 
0000200 
0000400 
0001 000 
0002000 
0004000 
001 0000 


Ignore break condition. 

Signal interrupt on break. 

Ignore characters with parity errors. 
Mark parity errors. 

Enable input parity check. 

Strip character. 

Map NL to CR on input. 

Ignore CP. 

Map CR to NL on input. 

Map upper-case to lower-case on input. 
Enable start/stop output control. 

Enable any character to restart output. 
Enable start/stop input control. 


If IGNBPK is set, the break condition (a character framing 
error with data all zeros) is ignored, that is, not put on 
the input queue and therefore not read by any process. Oth- 
erwise if BRKINT is set, the break condition will generate 
an interrupt signal and flush both the input and output 
queues. If IGNPAR is set, characters with other framing and 
parity errors are ignored. 


If PARMPK is set, a character with a framing or parity error 
which is not ignored is read as the three character 
sequence: 0377 , 0, X, where X is the data of the character 
received in error. To avoid ambiguity in this case, if 
ISTRIP is not set, a valid character of 0377 is read as 
0377, 0377. Tf PARMRK is not set, a framing or parity error 
which is not ignored is read as the character NUL (0). 


If INPCK is set, input parity checking is enabled. If INPCK 
is not set, input parity checking is disabled. This allows 
output parity generation without input parity errors. 

If ISTRIP is set, valid input characters are first stripped 
to 7-bits, otherwise all 8~bits are processed. 

If INLCR is set, a received NL character is translated into 
a CR character. If IGNCR is set, a received CF character is 
ignored (not read). Otherwise if ICRNL is set, a received 
CP character is translated into a NL character. 


If IUCLC is set, a received upper-case alphabetic character 
is translated into the corresponding lower-case character. 

If IXON is set, start/stop output control is enabled, A 
received STOP character will suspend output and a received 
START character will restart output. All start/stop charac- 
ters are ignored and not read. If IXANY is set, any input 
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character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP charac- 
ters when the input queue is nearly empty/full. 

The initial input control value is all bits clear. 

The c o f 1 a g field specifies the system treatment of output: 


OPOST 

0000001 

Postprocess output. 

OLCUC 

0000002 

Map lower case to upper on output. 

ONLCF 

0000004 

Map NL 

to CR-NL on output. 

OCPNL 

000001 0 

Map CF 

to NL on output. 

ONOCP 

0000020 

No CF output at column 0. 

ONLPET 

0000040 

NL performs CP function. 

OFILL 

0000100 

Use fill characters for delay. 

OFDEL 

0000200 

Fill is 

DEL, else NUL. 

NLDLY 

0000400 

Select 

new-line del ays : 

NLO 

0 



NL 1 

0000400 



CPDLY 

0003000 

Select 

carriage-return delays: 

CFO 

0 



CPI 

0001 000 



CP2 

0002000 



C P 3 

0003000 



TABDLY 

001 4000 

Select 

horizontal-tab delays: 

TABO 

0 



TAB 1 

0004000 



TAB? 

001 0000 



TAB 3 

001 4000 

Expand 

tabs to spaces. 

BSDLY 

0020000 

Select 

backspace delays: 

BSO 

0 



B S 1 

0020000 



VTDLY 

0040000 

Select 

vertical-tab delays: 

VTO 

0 



VT 1 

0040000 



FFDLY 

01 00000 

Select 

form-feed delays: 

FFO 

0 



FF 1 

01 00000 




If OPOST is set, output characters are post-processed as 
indicated by the remaining flags, otherwise characters are 
transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is 
transmitted as the corresponding upper-case character. This 
function is often used in conjunction with IUCLC. 

If ONLCF is set, the NL character is transmitted as the CP- 
NL character pair. If OCFNL is set, the CF character is 
transmitted as the NL character. If ONOCF is set, no CF 
character is transmitted when at column 0 (first position). 
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If ONLFET is set, the NL character is assumed to do the 
carriage-return function; the column pointer will be set to 
0 and the delays specified for CR will be used. Otherwise 
the NL character is assumed to do just the line- feed func- 
tion; the column pointer will remain unchanged. The column 
pointer is also set to 0 if the CR character is actually 
transmitted . 

The delay bits specify how long transmission stops to allow 
for mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of 0 indicates 
no delay. If OFILL is set, fill characters will be 
transmitted for delay instead of a timed delay. This is 
useful for high baud rate terminals which need only a 
minimal delay. If OFDEL is set, the fill character is DEL, 
otherwise NUL . 

If a form-feed or vertical-tab delay is specified, it lasts 
for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, 
the carriage-return delays are used instead of the new-line 
delays. If OFILL is set, two fill characters will be 
tr an sm i tted . 

Carriage-return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 is 
about 0.15 seconds. If OFILL is set, delay type 1 transmits 
two fill characters, and type 2 four fill characters. 

Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 
specifies that tabs are to be expanded into spaces. If 
OFILL is set, two fill characters will be transmitted for 
any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 
one fill character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c cflag field describes the hardware control of the ter- 
minal : 


CBAUD 

0000017 

Baud rate; 

B0 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

B 1 1 0 

0000003 

110 baud 

B13M 

0000004 

134.5 baud 
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B1 50 

0000005 

1 50 baud 

B20 0 

0000006 

200 baud 

B 3 0 0 

0000007 

300 baud 

B600 

000001 0 

600 baud 

B 1 2 0 0 

000001 1 

1200 baud 

B1 800 

000001 2 

1800 baud 

B2400 

000001 3 

2400 baud 

B4800 

000001 4 

4800 baud 

B9600 

000001 5 

9600 baud 

EXTA 

000001 6 

External A 

EXTB 

000001 7 

External B 

CSIZE 

0000060 

Character size: 

CS5 

0 

5 bits 

CS6 

0000020 

6 bits 

CS7 

0000040 

7 bits 

CS 8 

0000060 

8 bits 

CSTOPB 

00001 00 

Send two stop bits, else one. 

CREAD 

0000200 

Enable receiver. 

PARENB 

0000400 

Parity enable. 

PARODD 

0001000 

Odd parity, else even. 

HUPCL 

0002000 

Hang up on last close. 

CLOCAL 

0004000 

Local line, else dial-up. 


The CBAUD bits specify the baud rate. The zero baud rate, 
BO, is used to hang up the connection. If BO is specified, 
the data-terminal->ready signal will not be asserted. Nor- 
mally, this will disconnect the line. For any particular 
hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include the 
parity bit, if any. If CSTOPB is set, two stop bits are 
used, otherwise one stop bit. For example, at 110 baud, two 
stops bits are required. 

If PARENB is set, parity generation and detection is enabled 
and a parity bit is added to each character. If parity is 
enabled, the PAPODD flag specifies odd parity if set, other- 
wise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no 
characters will be received. 

If HUPCL is set, the line will be disconnected when the last 
process with the line open closes it or terminates. That 
is, the data-terminal-ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct 
connection with no modem control. Otherwise modem control 
i s a s sum ed . 

The initial hardware control value after open is B300, CS8, 
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CPEAD, HUPCL. 


The c 1 f I a g field of the argument structure is used by the 
line discipline to control terminal functions. The basic 
line discipline (0) provides the following: 


ISIG 

0000001 

ICANON 

0000002 

XCASE 

000000M 

ECHO 

000001 0 

ECHOE 

0000020 

ECHOK 

00 00 0M 0 

ECHONL 

0000100 

NOFLSH 

0000200 


Enable signals. 

Canonical input (erase and kill processing) 
Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo N L . 

Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the 
special control characters INTP and QUIT. If an input char- 
acter matches one of these control characters, the function 
associated with that character is performed. If ISIG is not 
set, no checking is done. Thus these special input func- 
tions are possible only if ISIG is set. These functions may 
be disabled individually by changing the value of the con- 
trol character to an unlikely or impossible value (e.g. 
0377). 


If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the assembly 
of input characters into lines delimited by NL , EOF, and 
EOL. If ICANON is not set, read requests are satisfied 
directly from the input queue. A read will not be satisfied 
until at least MIN characters have been received or the 
timeout value TIME has expired. This allows fast bursts of 
input to be read efficiently while still allowing single 
character input. The MIN and TIME values are stored in the 
position for the EOF and EOL characters respectively. The 
time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an upper-case letter 
is accepted on input by preceding it with a \ character, and 
is output preceded by a \ character. In this mode, the fol- 
lowing escape sequences are generated on output and accepted 
on input : 


for : use : 
x V 

! V! 

{ \( 

) \) 

\ \\ 

For example, A is input as \a, \n as \\n, and \N as \\\n. 
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If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possi- 
ble. If ECHO and ECHOE are set, the erase character is 
echoed as ASCII BS SP BS , which will clear the last charac- 
ter from a CRT screen. If ECHOE is set and ECHO is not set, 
the erase character is echoed as ASCII SP BS. If ECHOK is 
set, the NL character will be echoed after the kill charac- 
ter to emphasize that the line will be deleted. Note that 
an escape character preceding the erase or kill character 
removes any special function. If ECHONL is set, the NL 
character will be echoed even if ECHO is not set. This is 
useful for terminals set to local echo (so-called half 
duplex). Unless escaped, the EOF character is not echoed. 
Because EOT is the default EOF character, this prevents ter- 
minals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output 
queues associated with the quit and interrupt characters 
will not be done. 

The initial line-discipline control value is all bits clear. 

The primary i oc 1 1 ( 2 ) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the termi- 
nal and store in the termio structure refer- 
enced by ar g . 

TC SETA Set the parameters associated with the termi- 
nal from the structure referenced by arg. 
The change is immediate. 

TCSETAW Wait for the output to drain before setting 
the new parameters. This form should be used 
when changing parameters that will affect 
out put . 

TCSETAF Wait for the output to drain, then flush the 
input queue and set the new parameters. 

Additional ioc t 1 ( 2 ) calls have the form: 

ioctl (fildes, command, arg) 
in t ar g ; 

The commands using this form are: 
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TCSBPK Wait for the output to drain. If ar g is 0, 

then send a break (zero bits for 0.25 
second s) . 

TCXONC Start/stop control. If ar g is 0, suspend 
output; if 1, restart suspended output. 

TCFLSH If ar g is 0, flush the input queue; if 1, 

flush the output queue; if 2, flush both the 
input and output queues. 

FILES 

/dev/tty* 

SEE ALSO 

sttv ( 1 ) , ioc tl ( 2 ) . 
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NAME 

trace - event-tracing driver 

DESCRIPTION 

Trace is a special file that allows event records generated 
within the UNIX kernel to be passed to a user program so 
that the activity of a driver or other system routines can 
be monitored for debugging purposes. 

An event record is generated from within a kernel driver or 
system routine by invoking the tr sa v e function: 

trsave (dev, chno, buf, cnt) 
char dev, chno, * b u f , cnt; 

Dev is a m'inor device number of the trace driver; chno is an 
integer between 0 and 15 inclusive that identifies the data 
stream (channel) to which the record belongs; buf is a 
buffer containing the data for an event; and cnt is the 
number of bytes in buf . Calls to trsave will result in data 
being placed on a queue, provided that some user program has 
opened the trace minor device dev and has enabled channel 

chno . Event records consisting of a time stamp (4 bytes), 

the channel number (1 byte), the count (1 byte), and the 

event data ( cnt bytes) are stored on a queue until a 

system-defined maximum (TRQM'AX) is reached; an event record 
is discarded if there is not sufficient room on the queue 
for the entire record. The queue is emptied by a user pro- 
gram reading the trace driver. Each read returns an 
integral number of event records; the read count must, 
therefore, be at least equal to cnt plus six. 

The trace driver supports open , close , read , and ioc tl sys- 
tem calls. The ioc tl system call is invoked as follows: 

//include <sys/vpm.h> 
int fildes, cmd , arg; 
ioctl (fildes, cmd, arg); 

The values for the cmd argument are; 

VPMSETC-En abl e trace channels. This command enables each 
channel indicated by a 1 in the bit mask found in 
arg . The low-order bit (bit 0) corresponds to chan- 
nel zero, the next bit (bit 1) corresponds to channel 
1 , e tc . 

VPMGE TC-Ge t enabled channels. This command returns in arg a 
bit mask containing a 1 for each channel that is 
currently enabled. 

VPMCLRC-Di sable channels. This command disables the chan- 
nels indicated by a 1 in the bit mask found in arg . 
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SEE ALSO 

vpmsave(IM) , 


vpm (7 ) . 
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NAME 

tty - controlling terminal interface 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the 
control terminal associated with the process group of that 
process, if any. It is useful for programs or shell 
sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can 
also be used for programs that demand the name of a file for 
•output, when typed output is desired and it is tiresome to 
find out what terminal is currently in use. 

FILES 

/dev/ tty 
/dev/ tty* 

SEE ALSO 

d z ( 7 ) , tn 4 ( 7 ) , tn74(7) . 
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NAME 

intro - introduction to system maintenance procedures 
DESCRIPTION 

This section outlines certain procedures that will be of 
interest to those charged with the task of system mainte- 
nance. Included are discussions on such topics as boot pro- 
cedures, recovery from crashes, file backups, etc. 

BUGS 

No manual can take the place of good, solid experience. 
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NOT SUPPORTED AT THIS TIME 


NAME 

crash. m68 - what to do when the system crashes 
DESCRIPTION 

This entry gives at least a few clues about how to proceed 
if the system crashes. It can't pretend to be complete. 

In restarting after a crash, always bring up the system 
single-user, as specified in b_o(8), as modified for your 
particular installation. Then perform an f sck ( 1M) on all 
file systems which could have been in use at the time of the 
crash. If any serious file system problems are found, they 
should be repaired. When you are satisfied with the health 
of your disks, check and set the date if necessary, then 
come up multi-user. 

To even boot the at all, three files (and the directories 
leading to them) must be intact. First, the initialization 
program /etc/init must be present and executable. For i n i t 
to work correctly, /dev/console and /bin/sh must be present. 
If either does not exist, the symptom is best described as 
thrashing. In i t goes into a fork / ex ec loop trying to create 
a shell with proper standard input and output. 

If you cannot get the system to boot, a runnable system must 
be obtained from a backup medium. The root file system may 
then be doctored as a mounted file system as described 
below. If there are any problems with the root file system, 
it is probably prudent to go to a backup system to avoid 
working on a mounted file system. 

Repairi ng disks . The first rule to keep in mind is that a 
disk in need of repair should be treated gently; it 
shouldn't be mounted unless necessary, and if it is very 
valuable yet in quite bad shape, perhaps it should be copied 
before trying surgery on it. 
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F s c k ( 1 M ) is adept at diagnosing and repairing file system 
problems. It first identifies all of the files that contain 
bad (out of range) blocks or blocks that appear in more than 
one file. Any such files are then identified by name and 
f s c k requests permission to remove them from the file sys- 
tem. Files with bad blocks should be removed. In the case 
of duplicate blocks, all of the files except the most 
recently modified should be removed. The contents of the 
survivor should be checked after the file system is repaired 
to ensure that it contains the proper data. (Note that run- 
ning f s c k with the -n option causes it to report all prob- 
lems without attempting any repair.) 

Fsc k also reports on incorrect link counts and requests per- 
mission to adjust any that are erroneous. In addition, it 
reconnects any files or directories that are allocated but 
have no file system references to a '' lost+ found ’ ’ direc- 
tory. Finally, if the free list is bad (out of range, miss- 
ing, or duplicate blocks) f sck constructs a new one, with 
the operator’s concurrence. 

Wh y did it crash ? 

types a message on the console when a crash occurs. Here 
is the current list of such messages, with enough informa- 
tion to provide a possible remedy. The message has the form 
''panic: usually accompanied by other information. 
Left unstated in all cases is the possibility that hardware 
or software error produced the message in some unexpected 
way . 

blkd ev 

The routine was called with a nonexistent major 
device as argument. Definitely hardware or software 
error. 

d ev tab 

Null device table entry for’ the major device used as 
argument to getblk . Definitely hardware or software 
error . 


iinit 

An I/O error reading the superblock for the root file 
system during initialization. 


no fs 

A device has disappeared from the mounted-device table. 
Definitely hardware or software error. 


no imt 

Similar to ''no fs’’, but produced elsewhere, 

no clock 
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During initialization, neither the line nor programm- 
able clock was found to exist. 

I/O error in swap 

An unrecoverable I/O error during a swap. This 
shouldn’t be a panic, but it is hard to fix. 

out of swap space 

A program needs to be swapped out, and there is no more 
swap space. It has to be increased. This shouldn’t be 
a panic, but there is no easy fix. 


trap 

An unexpected trap has occurred within the system. 
This is accompanied by three numbers: a ''ps’’, which 
is the user’s stack pointer; ''pc’’, which is the 
user’s program counter; and a ''trap type’’ that 
encodes which trap occurred. The trap types are: 

2 bus error 

3 address error 

4 illegal instruction 

5 zero divide fault 

6 CHK instruction fault 

7 TRAPV instruction fault 

8 privileged instruction fault 

9 tracetrap 


10 

line 

1010 

emulator 



1 1 

line 

1111 

emul a tor 



24 

spurious 

interrupt 



32 

TRAP 

0 - 

system call 



33 

TRAP 

1 - 

breakpoint 



34 

TRAP 

2 - 

simulate DEC 

IOT 

instruction 

35 

TRAP 

3 - 

simulate DEC 

EMT 

instruction 

36 

TRAP 

4 - 

floating point ex 

cept ion 
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In some of these cases it is possible for hexadecimal 200 to 
be added into the trap type; this indicates that the proces- 
sor was in user mode when the trap occurred. If you wish to 
examine the stack after such a trap, dump the system. 

Interpretin g dumps . All file system problems should be 
taken care of before attempting to look at dumps. The dump 
should be read into the file /usr /tmp/ cor e ; cj)(1) can be 
used. At this point, you should execute ps -el -c 
/usr /tmp/ core and who to print the process table and a list 
of the users who were on at the time of the crash. 

SEE ALSO 

fsck(IM), bo(8), m68kops(8). 
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NAME 

diskconf - configures a hard disk for filesystem use 

SYNOPSIS 

diskconf -c Ctrl# -d drive# [-s si [s2...s833 C — b 3 C — z 3 
DESCRIPTION 

diskconf sub-divides disks into logical sections, configures 
disks for booting, and/or zeros disks. 

Parameters : 

-c Ctrl# Specifies the controller address on the SCSI 

bus to be accessed. 

-d drive# Identifies the disk on the specified con- 

troller to be configured. 

-s si [ s2 . . . s8 3 Spec i f i e s the logical sub-divisions of the 
disk. One or more zero values can be used to 
allocate remaining sectors. 

For example: 

-s 4000 0 5000 

configures a disk of 15000 sectors into three 
sub-divisions.. The first section contains 
4000 sectors, the second 6000, and the third 
5000 sectors. 

-s 4000 0 5000 0 

configures the same disk of 15000 sectors 
into four sub-divisions. The first contains 
4000 sectors, the second 3000, the third 
5000, and the fourth 3000 sectors. 

~b Configures the disk for booting. 

-z Zeros the disk. 

Note: This option destroys all data on the 
disk. 

diskoonf may only be invoked under the stand-alone environ- 
ment or by the super-user under UNIX. 


CAVEATS AND BUGS 

The -z option has not been implemented. 
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NAME 

format - format disks in preparation for filesystem building 
SYNOPSIS 

format -c Ctrl# -d drive# -s size -t ctrl_type [-1 label] 
DESCRIPTION 

format hard formats disks connected to SCSI compatible con- 
trollers. When invoked, commands are sent to the appropri- 
ate controller to initiate formatting on the requested 
drive. 

Par ameters : 

~c Ctrl# Specifies the controller address on the SCSI 

bus to be accessed. 

~d drive# Identifies the disk on the specified con- 

troller to be formatted. 

-s size Identifies the drive type and size (model 

number i s used ) . 

size must be one of: 
st506 (6 MB) 

5006h (6 MB) 

50 1 2h (1? MB) 

50 1 8h (18 MB) 

«t ctrl_ type Specifies the type of controller at the 

address given by -c Ctrl#. 

ctrl_type must be one of: 
ad apt ec 
ad aptec55 

-1 label An optional 8 character label to be recorded 

in sector 0 of the hard disk. 


Due to the length of time required by the controller to for- 
mat the disk, format will take awhile to complete. 

Note: This program will destroy all data on a disk, so use 
it with care. None of the data on the disk is saved and 
format is not limited by the logical sub-divisions of the 
disk (see d i skconf ( 1 M/ 1 SA ) ) . format may only be invoked 
under the stand-alone environment or by the super-user under 
UNIX. 

DIAGNOSTICS 

If an unsupported size or type of controller is specified 
the supported types and/or sizes will be displayed. A con- 
troller number and type, drive number, and disk size must be 
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specified. 

SEE ALSO 

diskconf(8) 

CAVEATS AND BUGS 

If format is invoked with an incorrect controller type (ie 
the controller specified is different than the controller 
found) the results will be incorrect. The data will be des- 
troyed and there is the possibility of receiving an error 
from the SCSI strategy routine (stating that the mode select 
command is incorrect). 

Remember, this command will destroy all data on the speci- 
fied disk, so use it with care! 
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NOT SUPPORTED AT THIS TIME 


NAME 

mk - how to remake the system and commands 

DESCRIPTION 

All source for 

is in a source tree distributed in the directory /usr/src. 
This includes source for the operating system, libraries, 
commands, miscellaneous files necessary to the running sys- 
tem, and procedures to create everything from this source. 

The top level consists of the directories cmd, lib, uts, 
head, and stand as well as commands to remake each of these 
directories. These commands are named :rnk , which remakes 
everything, and :mkdir where dir is the directory to be 
recreated. Each recreation command makes all or part of the 
piece; over which it has control. :mk runs each of these 
commands and thus recreates the whole system. 

The lib directory contains libraries used when loading user 
programs. The largest and most important of these is the C 
library. All libraries are in sub-directories and are 
created by a makefile or runcom . A runcom is a shell com- 
mand procedure used specifically to remake a piece of the 
system. : mkl ib rebuilds the libraries that are given as 
arguments. The argument \* causes it to remake all 
libraries. 

The head directory contains the header files, usually found 
in /usr/include on the running system. ; mkhe ad installs 
those header files that are given as arguments. The argu- 
men t \« causes it to install all header files. 

The uts directory contains the source for the operating sys- 
tem. : mku t s (no arguments) invokes a series of makefiles 
that recreate the operating system. 

The stand directory contains stand-alone commands and boot 
programs. : mks t and rebuilds and installs these programs. 

The cmd directory contains files and directories. : mkcmd 
transforms source into a command based upon its suffix (.1, 
,y, ,o, .s, .sh) , or its makefile (see m ake ( 1 ) ) or runcom. 
A directory is assumed to have a makefile or a runcom that 
takes care of creating everything associated with that 
directory and its sub-directories. Makefiles and runcoms 
are named com m and .mk and command. rc respectively. 
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: m k c ir. d recreates commands based upon a makefile or runcom if 
one of them exists; alternatively commands are recreated in 
a standard wav based on the suffix of the source file. All 
commands requiring more than one file of source are grouped 
in sub- d i r ec to r i e s , and must have a makefile or a runcom. C 
programs (,c) are compiled by the C compiler and loaded 
stripped with shared text. Assembly language programs ( .s) 
are assembled with /usr/include/sys .s which contains the 
system call definitions. Yacc programs ( ,y) and lex pro- 
grams (.1) are processed by yac c ( 1 ) and lex ( 1 ) respectively 
before C compilation. Shell programs (.sh) are copied to 
create the command. Each of these operations leaves a com- 
mand in ,/cmd which is then installed by using / etc/ in stall . 

The arguments to : mkcmd are either command names, or subsys- 
tem names. The subsystems distributed with 
are; acct, graf, sees, and text. Prefacing the : mkcmd 
instruction with an assignment to the shell variable $AFGS 
causes the indicated components of the subsystem to be 
rebuilt. 

The entire sees subsystem can be rebuilt by: 

/usr/src/imkcnid sees 

while the delta component of sees can be rebuilt by: 

ARCSs" delta" /usr /sr c/ :mkcmd sees 

The log command, which is a part of the stat package, which 
is itself a part of the graf package, can be rebuilt by: 

ARGS="stat log" /usr /sre/ :mkcmd graf 

The argument \* causes all commands and subsystems to be 
rebuilt. 

Makefiles, both in ,/cmd and in sub-directories, have a 
standard format. In particular : mkcmd depends on there 
being entries for install and clobber . Install should cause 
everything over which the makefile has jurisdiction to be 
made and installed by / etc/ in Stall . Clobber should cause a 
complete cleanup of all unnecessary files resulting from the 
previous invocation. 

Most of the runcoms in ,/cmd (as opposed to sub-directories) 
relate in particular to a need for separated instruction and 
data (I and D) space. 
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Ct i m e checks the environment (see env ir on ( 5 ) ) for the time 
zone. This results in time zone conversions possible on a 
per-process basis. /etc/profile sets the initial environ- 
ment for each user, and /etc/rc sets it for certain system 
daemons. These two programs are the only ones which must be 
modified outside of the eastern time zone. 

An effort has been made to separate the creation of a com- 
mand from source, and its installation on the running sys- 
tem. The command /etc/install is used by : mkcm d and most 
makefiles to install commands in the proper place on the 
running system. The use of install allows maximum flexibil- 
ity in the administration of the system. Install makes very 
few assumptions about where a command is located, who owns 
it, and what modes are in effect. All assumptions may be 
overridden on invocation of the command, or more permanently 
by redefining a few variables in install. The object is to 
install a new version of a command in the same place, with 
the same attributes as the prior version. 

In addition, the use of a separate command to perform 
installation allows for the creation of test systems in 
other than standard places, easy movement of commands to 
balance load, and independent maintenance of makefiles. The 
minimization of makefiles in most cases, and the site 
independence of the others should greatly reduce the neces- 
sary maintenance, and allow makefiles to be considered part 
of the standard source. 

SEE ALSO 

install(IM), make( 1 ) . 
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NAME 

spare - replace a bad sector with a good one 

SYNOPSIS 

spare -c? -d? -s? [ < bl oc kl i st > ] 

DESCRIPTION 

Spare replaces the specified blocks in <blocklist> with 
spare blocks. Spare only works on one slice at a time. 
Spare updates the information in absolute sector 0 and 
writes a copy to the alternate sector (129). 

-c? , -d? , and -s? is the controller, unit, and slice 
number(s) respectively. These correspond to the numbers in 
the device name. 

<blocklist> is a list of up to 16 slice relative blocks to 
be spared. If blocklist is not supplied, spare simply reads 
a valid copy of sector 0 and writes to both sector 0 and the 
alternate sector (129). This is a convenient way to recover 
from a damaged sector 0. 

If there is not enough spare sectors, spare displays a mes- 
sage. If sector 0 is bad, spare reads the alternate sector 
(129) and displays a warning message automatically. 

EXAMPLE 

spare -cO -dO -s3 69 

This example illustrates replacing bad block 69 in slice 3 
of disk 0, controller 0, with a spare sector if one is 
available. 
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NAME 

sparelist - list the spared sectors associated with a slice 
SYNOPSIS 

sparelist [device] in UNIX 

- or - 

sparelist [-c? -d? -s?] in STANDALONE 

DESCRIPTION 

Sparelist lists the base sector, the total number of sectors 
in that slice, the number of alternate (spared) sectors 
allocated, and the sectors that already have been spared. 
If no device is specified, sparelist lists information for 
all of the disks on the system. 

Use the first form of sparelist if currently running under 
UNIX, and the second form if running in the standalone 
environment. 

[device] is the device name (e.g., / d ev/ d sk/ cO dOs 3 ) . 

-c? -d? -s? is the controller, unit, and slice number which 
correspond to the numbers in the device name. 

Sparelist requires the user to become a super-user to envoke 
it. If sector 0 is bad, spare reads the alternate sector 
(129) and displays a warning message automatically. 

EXAMPLE 

sparelist / d e v/ d sk/ cO do s 3 

- or - 

sparelsit -cO -do -S3 

Both forms of the example above, displays the spare sector 
information for disk controller 0, unit 0, slice 3. 
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